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Intro___ 

introduction to machine related miscellaneous features 
and files 

Description 


The hardware-dependent section (HW) contains information useful in 
maintaining the system. Included are descriptions of files, devices, 
tables and programs that are important in maintaining the entire sys¬ 
tem that are directly related to the kind of computer on which the sys¬ 
tem runs. This section is intended for use with 80386-based comput¬ 
ers. 
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80387 

math coprocessor 

Description 


The 80387 is the INTEL math co-processor for the 80386. The kernel 
tests for the presence of an 80387 at startup. 

If your system has an 80387, you must turn off a switch on the main 
system board in order to enable 80387 interrupts. Check your hard¬ 
ware manual to determine the proper switch and setting. If your sys¬ 
tem does not have an 80387, or the switch is on, the kernel will run a 
set of emulator routines which are much slower. 

The C compiler available with the program development package gen¬ 
erates the appropriate 80387 opcodes. C routines compiled with this 
compiler have run as much as 200 times as fast as the emulated code. 
In particular, the standard math library routines run considerably fas¬ 
ter if you have an 80387. 

The overflow, division by zero, and invalid operand exceptions return 
a SIGFPE signal. This signal can be caught. The rest of the 80387 
floating point exceptions (underflow, denormalized operand, and pre¬ 
cision error) are masked. 

Notes 


The emulator returns meaningless information on divide by zero. 

There is no obvious way to tell which 80387 exception generated the 
SIGFPE. 

Because of design defects in Intel’s 80386 chip (B1 stepping), the 
Intel 80387 math co-processor may not operate correctly in some com¬ 
puters. The problem causes the CPU to hang when 
DMA/paging/coprocessor accesses are occurring. A workaround for 
this problem has been engineered that is engaged by using a special 
string at boot time: 

Boot 

: unix a31 
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This workaround may not work on all machines; some hardware is 
designed such that it will not work. If it is successful, the following 
message is displayed: 


r 


A31 CPU bug workaround in effect 


If unsuccessful, the following is displayed: 


A31 CPU bug workaround not possible for this machine 


The bootstring may also be added to the end of the default bootstring 
(DEFBOOTSTR) found in / etc /default!boot. 

If you cannot use this workaround, you have two options. You may 
replace the 386 chip with a newer release of the 386 chip (a D-step 
part), or you can bypass the 387 chip by adding the ignorefpu keyword 
in your boot command as follows: 

Boot 

: unix ignorefpu 

This means that the operating system will not use the 387 chip, but 
you need not remove it physically; the coprocessor is still usable from 
DOS. To automatically bypass the 387 chip every time you boot your 
system, add the ignorefpu keyword to the /etc/default/boot file. See 
boot(HW) for more information. 

For further information, see the Intel publication: Intel 80387 
Programmer’s Reference Manual. 
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audit _ 

audit subsystem interface device 

Description 


The audit subsystem provides two minor devices for interfacing to the 
audit subsystem. One device, /dev/auditr, is used exclusively by the 
audit daemon, auditd(ADM), for the purpose of reading the subsystem 
audit collection file records. The other device, /dev/auditw, is used by 
application programs which are privileged to write audit records to the 
audit subsystem. This device may be opened by as many applications 
as is necessary but may only be opened for writing. The device also 
support a host of ioctl(S ) functions to perform audit subsystem control. 

The audit read device provides the usual character device driver 
open(S), read{ S), and close{ S) routines. Writing to this device is not 
permitted. Read requests are satisfied by the subsystem and optimize 
the efficiency of the daemon and the performance of the system. Read 
requests are satisfied when sufficient data has accumulated to meet an 
administrator specified threshold. Until the data is available, the read 
request will block. In this manner, the daemon will receive suffi¬ 
ciently large blocks of data on each read to allow sufficient compac¬ 
tion. Also, context switch frequency is greatly reduced since the reads 
will not be satisfied on small blocks or when no data is available. 

The audit write device provides an interface to the audit subsystem for 
applications that have the writeaudit privilege. The device supports 
the openR(S), closed S), write(S), and ioctl( S) entry points. Once 
opened, an application may compose an audit record and write( S) it to 
the device for inclusion in the collection file. The writing of an audit 
record is an atomic action in that the entire record must be presented 
to the subsystem with a single write. It is incumbent on the application 
to gather the record into a single buffer before writing it to the device. 

The format of an audit record depends upon the type of event being 
audited. All audit records begin with a common audit record header 
defined by the audit_header structure in the file sysaudit.h. 


struct audit header { 


ushort 

rec_length; 

timejt 

tstairp; 

ulong 

event_id; 

ushort 

event_type; 

ushort 

record_type; 

ushort 

obj_type; 

ushort 

pid; 


/* total record length */ 
/* date/time of record */ 
/* event sequence id */ 

/* event classification */ 
/* record format */ 

/* object type */ 

/* process_id */ 


The event type, recordJype, and pid fields must be filled, .by the 
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application; all other fields are filled by the Audit subsystem. The 
event types are defined in the header file and provide a method of 
categorizing audit records into groups such as Login events or System 
Administrator events. The record type informs the subsystem of the 
record template type. This information is also retained with the record 
when it is written to the collection file by the subsystem since it is 
required at data reduction time. 

Some of the record types have variable length string areas that follow 
the fixed portion of the audit record. Each text string that is part of the 
record has its size recorded in a count field. Each string is null- 
terminated and the count must include the null character. When the 
record is written to the device, the amount of data written includes the 
fixed portion plus all text strings. The supported record types for 
application programs are: 


RTJLOGIN 
RTPASSWORD 
RTDATABASE 
RTSUBSYSTEM 
RT LOCK 
RT AUDIT 


login/logoff events 
password modifications 
protected database modifications 
privileged subsystem events 
terminal and account locking 
audit subsystem events 


Each record type indicates a unique record structure definition. The 
RTJLOGIN record uses the login_audit structure. It contains the fol¬ 
lowing fields, defined in sys/audit.h: 

struct login_audit { 

struct audit_header aud_hdr; 
char 
ushort 
ushort 
ushort 
dev_t 
ptr_t 
ptr_t 
#ifdef B1 

ptr_t 

#endif 
}; 


username [8]; 

code; 

luid; 

rgid; 

ttyd; 

cdir; 

terminal; 

sec level; 


/* login name */ 

/* function code */ 

/* login userid */ 

/* real gid */ 

/* controlling terminal */ 

/* current directory */ 

/* stdin terminal name */ 

/* login sensitivity level */ 


Username is the login or logoff user account name. The luid and rgid 
fields are those associated with the specified user account. The audit 
header, which precedes the login specific portion of the record, must 
have the record type field set to RTJLOGIN. The event type used 
for login/logoff is the ET LOGIN event. 
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The code field is used to distinguish between specific actions that may 
fall into a common category. For instance, the ET_LOGIN event 
category includes both successful and unsuccessful logins, and also 
logoffs. The code values, defined in the header file, indicate which of 
these occurred. 

The login audit record also contains two variable length text strings. 
These are the login terminal and the process current directory. The 
string area begins immediately following the fixed portion of the 
record. The size of each text string field is indicated by the ptr_t 
typedef field which contains the length of the string including the null 
character. The null character is considered part of the string. Once the 
strings have been calculated and the record completed, the length field 
in the audit record header is set to the size of structure plus the total 
lengths of the strings. This is the amount of data to write( S) to the 
audit device. 

Modifications to user passwords are audited by the password manage¬ 
ment subsystem. Each attempt, whether successful or not, results in an 
audit record of type RTPASSWORD being generated. The structure 
is defined in the syslsudit.h header file: 


struct passwd_audit { 

struct audit_header aud_hdr; 

char username[8]; /* login user name */ 

ushort code; /* function code */ 

}; 

The code value distinguishes between successful and unsuccessful 
attempts to change the password on the indicated user account. 

The system maintains a number of protected database files to support 
the system security policy. Attempts to modify the databases are 
audited with the RTJDATABASE type records. These records have 
the following format, as defined in <sys/audit.h>: 


struct database_activity { 
struct audit_header aud_ 
ptr_t command; 

ushort code; 

ushort object; 

long expect ed_val; 

long present_val; 

ptrjt action; 

ptrjt result; 

}; 


_hdr; 

/* command name */ 

/* Type of database audit */ 

/* object type */ 

/* Expected value of parameter */ 
/* Present value of parameter */ 
/* security action that failed */ 
/* result of failure */ 


The dbase and code values identify the database and the specific 
action whether successful or not. A variable length text string area is 
provided to identify precisely what database field along with the old 
and new database field values. The audit header length field includes 
the size of the string area and the fixed portion of the record. 


March 15, 1989 


AUDIT-3 




AUDIT (HW) 


AUDIT (HW) 


Protected subsystems use the RTJSUBSYSTEM record type to record 
security related events that occur in subsystem components. Code is 
used to identify the subsystem generating the record. Both the com¬ 
mand and resulting action as well as the resulting failure are recorded 
in command, action and result respectively. 

struct subsystem_activity { 

struct audit_header aud_hdr; 
ptr_t command; /* command name */ 

ushort code; /* Subsystem type */ 

ptr__t action; /* action that failed */ 

ptr_t result; /* result of failure */ 

}; 

The RT_LOCK record type is used to audit user account and terminal 
locking events. The username identifies the user account which was 
locked or unlocked. Code distinguishes between the several events 
that result in the generation of a lock audit record. 

#include<sys/audit .h> 

struct lock_audit { 

struct audit_header aud_hdr; 
char username[12]; /* login username */ 

ushort code; /* lock function code */ 

ushort trys; /* failed attempts */ 

}; 

Programs that interact with and control the audit subsystem are 
audited with the RT_AUDIT record type. The subsystem is enabled 
and disabled by an application program. The same is true of subsystem 
parameter initialization and modification. Events such as the initiation 
and termination of the audit daemon, the execution of the recovery 
mechanism, data reduction and report generation, and audit file 
archival are all audited. 

The text string portion of the audit record is only applicable for the 
audit enable function since the initial subsystem collection file must 
be specified for the daemon log file. All other audit records do not use 
this field. The code indicates which of the above events took place. 

struct audit_actions { 

struct audit_header aud_hdr; 

ushort code; /* audit function code */ 

ptr__t textl; /* initial collection file */ 

In¬ 
struct passwd_audit { 

struct audit_header aud_hdr; 

char username [8]; /* login user name */ 

ushort code; /* function code */ 

}; 
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The audit device supports a number of ioctl(S) functions to control the 
audit subsystem. The format of the ioctl(S) calls is: 

ioctl (fildes, command, arg) 
int fildes, command; 
struct audit_init *arg; 

-or- 

struct audit ioctl *arg; 

-or- 

struct audit stats *arg; 

The audit_init structure is only used for AUDIT_ENABLE command 
to perform subsystem initialization. The structure is defined as fol¬ 
lows: 


struct audit_ 

_init { 


uint 

buf_length; 

/* lngth of data including header */ 

mask_t 

audit flags[1]; 

/* audit control flags */ 

mask_t 

event mask [AUDIT MASK SIZE]; /* system event mask */ 

Uint 

read_count; 

/* daemon read count to satisfy */ 

uint 

write_count; 

/* write count for coll, file flush */ 

long 

write_time; 

/* write flush time in seconds */ 

long 

switch_count ; 

/* collection file size maximum */ 

long 

caf_maxsize; 

/* compacted audit file max size */ 

uint 

dir_count; 

/* directory count */ 

uint 

uid_count; 

/* uid selection count */ 

uint 

gid count; 

/* gid selection count */ 

ulong 

dir_offset; 

/* fseek of directory names */ 

ulong 

uid_offset; 

/* fseek of uids to select */ 

ulong 

gid offset; 

/* fseek of gids to select */ 

uint 

buff count; 

/* number of collection file buffers */ 

ulong 

session; 

/* system boot session number */ 

short 

auditjuid; 

/* audit user uid */ 

short 

audit_gid; 

/* audit group gid */ 


}; 


The subsystem initialization parameters are established through the 
menu interface and are written to a parameter file. This file is read and 
used to fill out the above structure to initialize the subsystem. 

The event mask is a bit mask of the selected events to audit during the 
session. Only events that are enabled will generate audit records. The 
readcount value is used by the subsystem to satisfy audit daemon 
reads. Only when the specified amount of data is available in the col¬ 
lection file will the read be satisfied. 

The flushing of the internal subsystem buffers to the collection file is 
controlled by the write_count and writeJime fields. When the 
specified amount of data has accumulated, the buffers will be flushed 
to disk. A time interval in seconds can also be set which will cause the 
fl ushin g of data to disk after a certain period of elapsed time. 

The switch count controls the size to which subsystem collection files 
may grow until a file switch is performed. The size of the output com¬ 
paction files written by the audit daemon are controlled by the 
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cafjnaxsize parameter. When these files reach this specified size, the 
daemon performs a switch to a new compaction file and records this 
fact in the audit session log file. Session is the current session value 
that is used in file name generation. The buff_count value dete rmin e 
the number of file system blocksize buffers to be allocated by the sub¬ 
system for the purpose of internal buffering. At least 2 buffers are alio- 
cated while 4-6 is optimal. 

Dir_count is the number of collection file and compaction file direc¬ 
tories that are available to both the subsystem and the audit daemon 
for the creation of their respective files. If a file write error occurs, 
both will attempt to use an alternate directory. Both will terminate 
only when all directories have been tried without success. The direc¬ 
tory names are located in the variable length directory area following 
the fixed portion of the initialization record. Each pathname is a null- 
terminated string. The dir_offset field points to the start of this vari¬ 
able length text string area with respect to the start of the structure. 

The audit subsystem is capable of selective audit record generation 
based on user and group IDs. These values may be specified to the 
subsystem at initialization time using the uid_count and gid_count 
values. The actual list of user and group Ids are located at the end of 
the structure in a variable length table of short integers. The offsets 
where the ID arrays may be found are located by the uid_offset and 
gid_offset values. 

The audit_uid and audit_gid fields are used to communicate certain ID 
values to the subsystem since these are used to create files with specif¬ 
ic owners and groups for security purposes. 

All remaining ioctl(S) commands except AUDIT_STATS use the 
audit_ioctl structure. The audit_ioctl structure is defined by the fol¬ 
lowing: 

struct audit__ioctl { 

uint read_count; /* daemon read count */ 

uint write_count; /* write count for file flush */ 

long write_time; /* write flush thne */ 

mask_t user_control [AUDIT_MASK_SIZE]; /* control mask */ 

mask_t user_disp [AUDIT_MASK_SIZE]; /* disposition mask */ 

mask_t systemjnask [AUDIT_MASK_SIZE]; /* system event mask */ 

}; 

The AUDIT_STATS ioctl command uses the following structure for 
statistic retrieval and display. 

struct audit_stats { 


uint 

session; 

/* 

current session number */ 


uint 

sequence; 

/* 

current sequence number */ 


ulong 

total_bytes; 

/* 

total bytes written */ 


ulong 

total_recs; 

/* 

total records written */ 


ulong 

syscall recs; 

/* 

system call audit record count 

*/ 

ulong 

syscall_norecs; 

/* 

system call audit record count 

*/ 

ulong 

appl_recs; 

/* 

application audit record count 

*/ 
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ulong read_count; /* number of device reads */ 

ulong write_count; /* number of device writes */ 

ulong coll_files; /* number of collection files */ 

ulong buffers_used; /* maximum audit buffer usage */ 

ulong buffer_sleep; /* number of audit write sleeps */ 

}; 

The commands supported by the audit device are: 

ENABLE Initialize and enable the audit subsystem for the gen- 


SHUTDOWN 

eration of audit records. 

Notify the audit subsystem that a system shutdown is 
in progress. 

DISABLE 

Terminate the audit subsystem and close all collec¬ 
tion files. The audit daemon is also terminated after 
the last audit record has been read from the subsys¬ 
tem. 

SYSMASK 

Modify the audit subsystem event mask that controls 
the generation of audit records based on certain 
event types. 

USERMASK 

Modify the user event mask for a process. Each pro¬ 
cess has a mask which can be used to always or 
never audit certain event types regardless of the sys¬ 
tem event mask. The mask is a control mask which 
indicates for each bit set on that the generation of 
records for the corresponding event type is controlled 
by the second mask. The second mask is the 
enable/disable mask which determines whether the 
event is always or never audited. If a control mask 
bit is 0, the event is controlled by the system event 
mask. 

FLUSH 

Modify the write count and time interval values. 

DAEMON 

Modify the audit daemon read count value. 

ACK 

Used by the daemon to acknowledge certain events 
such as recognition of system shutdown and the disa¬ 
bling of the audit subsystem. Provides a synchroniza¬ 
tion means between the subsystem and the daemon. 

MOUNT 

The system has transitioned to multi-user state and 
alternate audit directories are now mounted and 
available. 

STATS 

Retrieve the current audit subsystem statistics from 
the audit device. 
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IDS Specify the user and group IDs to use for selective 

audit generation. 

Ioctl(S) calls will fail if any of the following are true: 

[EPERM] The process required SelfAudit privilege but did not 
have it. 


[EEXIST] An attempt is made to enable audit and it is already 
running. 


[EACCES] An open attempt is made on the audit device and the 
calling process does not have the configaudit or wri- 
teaudit authorization. 

[EBADF] Fildes is not a valid open file descriptor. 

[EFAULT] Arg points to an illegal address. 

[EINVAL] Command is an illegal value. 

Files 


/dev/auditr 

/dev/auditw 

See Also 


auditd(ADM), auditcmd(ADM), “Maintaining System Security,” 
chapter of the System Administrator s Guide 

Diagnostics 


Upon successful completion, the device returns a 0. Otherwise, a -1 is 
returned and errno is set to indicate the error. 

Value Added 


audit is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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boot _ 

UNIX boot program 

Description 


boot is an interactive program used to load and execute stand-alone 
UNIX programs. It is used primarily for loading and executing the 
UNIX kernel, but can load and execute any other programs that are 
linked for stand-alone execution, boot is a required part of the Operat¬ 
ing System and must be present in the root directory of the root 
filesystem to ensure successful loading of the UNIX kernel. 

The boot program is invoked by the system each time the computer is 
started. To restart the system without going through lengthy shutdown 
procedures, you can use the reboot command. This causes the system 
to reboot after shutting down without waiting for keyboard input. See 
haltsys (ADM) for more information. 

For diskette boot, the procedure has three stages: 

1. The ROMs load the boot block from sector 0 of the floppy, where 
sector 0 of the disk is the same as sector 0 of the filesystem. 

2. The boot block loads boot from the floppy filesystem. 

3. boot executes and prompts the user. 

For fixed-disk boot, the procedure has five stages: 

1. The ROMs load in the masterboot block from sector 0 on the hard 
disk. 

2. The masterboot block then loads the partition boot block (bootO) 
from sector 0 of the active partition (see fdisk(ADM)). 

3. Then, assuming the UNIX partition is active, bootl is loaded from 
IK into the active partition. Bootl spans 20 physically contiguous 
IK blocks on the disk. 

4. bootl loads boot from the UNIX filesystem. 

5. boot executes and prompts the user. 

/boot and /unix may lie on tracks that have been mapped by 
badtrk( ADM), masterboot, bootO, and bootl cannot lie on bad tracks. 

The fixed-disk boot procedure is invoked if the diskette drive is empty. 
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When first invoked, boot prompts for the location of a program to load 
by displaying the message: 

UNIX System V 

Boot 


To specify the location of a program, a device and filename must be 
given. The filename must include the full pathname of the file con¬ 
taining the stand-alone program. You can display a list of the current 
allowable device names by typing a question mark (?). 

The format for the device and pathname is as follows: 

xx(m,o)filename 

or 

xx(m)filename 

where: 

xx = device name 

(‘hd’ for the hard disk or ‘fd’ for diskette device) 
m - minor device number 

(40 for the root filesystem on the hard disk) 
o = offset in the partition (usually 0). This is optional. 
filename = standard UNIX pathname. Must start with a 
slash if the program is not in the root directory. 

All numbers are in decimal. See the manual pages for hd(KW) and 
fd( HW) for minor device numbers of these devices. Specifying the 
offset is optional. The location of the program to be loaded must 
always be entered first on the command line and be present if other 
boot options are specified either on the command line or in 
/etc/default/boot. 

If you want boot to pause and wait for a RETURN before executing the 
program that it loads, enter the word “prompt” on the command line. 
For example, if you enter “prompt” and press RETURN boot prints 
the following message and waits for you to press the RETURN key 
again: 


Loaded, press <RETURN>. 

The prompt can be changed to another string as in this example: 

prompt="change diskettes now" 

boot loads unix from the diskette, prints the message “change 
diskettes now”, and waits for RETURN to be pressed. No other charac¬ 
ters can appear between “prompt”, the “=” sign, and the prompt 
string, although string may contain spaces. When you press RETURN 
unix begins execution. “Prompt” can be set either on the command 
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line or in /etc/default/boot. If a prompt is not specified, boot executes 
the loaded program without pausing. 

If you have just loaded the boot program from the distribution 
diskette, simply press <RETURN> and boot defaults to the correct 
values. 

To load from a hard disk, enter: 

hd(40,0)unix 

To use the default bootstring specified in /etc/default/boot, simply 
press <RETURN> when the system displays the boot prompt, and boot 
uses the values specified by DEFBOOTSTR in /etc/default/boot. 

If nothing is typed after a short while and AUTOBOOT is set to YES in 
the default root filesystem’s /etc/default/boot file, boot times out and 
behaves as though a <RETURN> had been pressed, except that an 
“auto” is added to the boot string. (If, in addition to 
AUTOBOOT=YES, TIMEOUT^ is defined, boot waits n seconds 
before timing out.) boot proceeds through the boot procedure, and 
init( M) is passed a -a flag with no “prompt”. 

If you wish to install DOS on the hard disk, it is recommended that you 
do so before you install the Operating System. See the manual page 
for dos(C). However, once you install DOS, you can boot it at the 
UNIX boot prompt by entering “dos”. 

During installation, a custom masterboot is placed on the hard disk. If 
a non-standard disk is specified, its parameters are stored and enabled 
in this masterboot. 

Configuring the Kernel 


boot passes any bootstring typed at the boot prompt to the kernel, 
except for the “prompt” string. 

The kernel reads the bootstring to determine which peripherals are the 
root, pipe, and swap devices. If no devices are specified in either the 
/etc/default/boot description or on the command line, the default de¬ 
vices compiled into the kernel are used. 
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Additional arguments in the bootstring can alter this default 
these arguments have the form: 


action. 


dev=xx(m,o) 

or 

dev=xx(m) 

where: 

dev = the desired system device (root[dev], pipefdev] 
or swapfdev]) 

xx, m,o = same as for the boot device 


If any combination of root, pipe, or swap is specified, then those sys¬ 
tem devices will reside on that device, with the unspecified system de¬ 
vices using the defaults compiled in the kernel. Setting one device 
does not affect the default values for the other system devices. 


Selecting the System Console 


You can select the system console at boot time either by entering the 
o^^_ sy . st ^, at / t h e boot prompt, or by placing the keyword 
STTY-x m the file /etc/default/boot. The letter x represents either 
a number or a string parameter. 


If you use the systty=x command at boot time, boot uses the string 
parameter x to pass the selected console device to the kernel The 
values of the bootstring parameter systty are: 


sio Serial port COM1 
scm Display adapter 


For example, to assign the system console to the serial 
enter this command at the boot prompt: 


port at COM1, 


systty=sio 


If you do not specifically set the system console at boot time, the boot 
program follows these steps to determine the system console: 

«veTTv dS /etc/default/boot and looks for the keyword 
all Y-x, where x is a number that specifies the system console 


1 indicates the serial adapter at COM1 
0 indicates the display adapter 


SYSTTY is not found or /etc/default/boot is unreadable, boot 
checks for a display adapter and assigns it as the system console. 


U !l°. di &u da ? te o r is found ’ boot looks for COM1, sets the serial 
port to 9600 baud, 8 data bits, 1 stop bit, and no parity, and uses it 
as the system console. 
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Thus, to have boot automatically set the system console to the serial 
port at COM1, enter this line in /etc/default/boot: 

SYSTTY=1 

Aliasing 


A set of system devices can be aliased to a single keyword by defining 
the keyword in the file /etc/default/boot. This keyword can then be 
entered on the “Boot” command line and the boot program then reads 
the corresponding system devices from /etc/default/boot and pass 
them to the kernel. An alias has the following form: 

key=file [root=xx(m) pipe=xx(m) swap=xx(m) prompt[="slrwg"]] 

In all cases, the device specification can also have the format 
dev=xx(m,o), where o is the offset. 

For example, if you have a root file system on a second hard disk and 
want to use it, but want to boot using the unix located on the first hard 
disk, enter the following line into the /etc/default/boot description: 

disk2=hd(40,0)unix root=hd( 104,0) \ 
prompt="Using second disk" 

The next time you boot the system from the first hard disk, enter 
“disk2” in response to the “Boot” prompt, unix will be loaded from 
the first hard disk, and when you see the message, “Using second 
disk”, press RETURN unix will now boot and use the root filesystem 
on the second hard disk. Note that you must edit the /etc/default/boot 
file in the root filesystem on the device from which boot will be read, 
in this case the first hard disk. 

Another example: suppose you want to boot off the second drive 
(hdlO) and use the root filesystem and swap space of the second drive. 
At the boot prompt, use the following bootstring: 

hd(104)unix root=hd(104) pipe=hd(104)\ 
swap=hd(105) 

Once booted, you must create the device nodes for the second drive 
for use by the utilities: 

fixperm -c -dHDl /usr/lib/mkdev/perms/HD 

Boot Options 

Boot options can be changed via keywords in /etc/default/boot. The 
following keywords are recognized by boot: 
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AUTOBOOT=YES 


DEFBOOTSTR=5fn>zg 


SYSTTY=jc 


RONLYROOT=NO 


FSCKFIX=YES or NO 


If YES, boot automatically loads 
UNIX after a delay time specified by the 
TIMEOUT parameter. The default value is 
60 seconds. 

string is used as the default bootstring for 
timeouts or when only a <RETURN> is 
entered at the boot prompt. There can be no 
white space between DEFBOOTSTR, the 
“=” sign and string. 

If x is 1, the system console device is set to 
the serial adapter at COM1. If x is 0 the sys¬ 
tem console is set to the main display 
adapter. 

Whether or not the root filesystem is to be 
mounted readonly. This should only be set 
to YES during installation. 

Whether or not fsck( ADM) fixes any root 
system problems by itself. If the variable is 
set to YES, then fsck is run on the root 
filesystem with the -rr flag. 


MULTIUSER-YES or NO Whether or not init( M) invokes sulogin or 

proceeds to multiuser mode. 

PANICBOOT=YES or NO Whether or not the system reboots after a 

panic(). This variable is read from 
/etc/default/boot by init. 

TIMEOUT=« n is the number of seconds to wait at the 

boot prompt before timing out and booting 
the kernel (if AUTOBOOT is set to YES). 


The following special boot options are for intended for use applica¬ 
tions with a special need to alter init’s tolerance for processes that 
need to be restarted. 

SPAWNJNTERVAL 

The number of seconds over which "init" will try to 
respawn a process SPAWNJLIMIT times before it gets 
mad. The default value is 120. 

SPAWN_LIMIT 

The number of respawns "init" will attempt in 
SPANWJNTERVAL seconds it generates an error mes¬ 
sage and inhibits further tries for INHIBIT seconds. The 
default value is 10. 
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SLEEPTIME 

Sets the time (in seconds) between calls to sync. 

INHIBIT 

The number of seconds "init" ignores an entry it had trou¬ 
ble spawning unless a "telinit Q" is received. The default 
value is 300. 

Diagnostics 

If an error occurs, masterboot displays an error message, and locks the 
system. The following is a list of the most common messages and 
their meanings: 

IO ERR An error occurred when masterboot tried to read in the 
partition boot of the active operating system. 

BAD TBL The bootable partition indicator of at least one of the op¬ 
erating systems in the /disk table contains an unrecogniz¬ 
able code. 

NO OS There was an unrecoverable error that prevented the 
active operating system’s partition boot from executing. 


When boot displays error messages, it returns to the “Boot” prompt. 
The following is a list of the most common messages and their mean¬ 
ings: 

bad magic number 

The given file is not an executable program, 
can’t open <pathname> 

The supplied pathname does not correspond to an existing file, or 
the device is unknown. 


Stage 1 boot failure 

The bootstrap loader cannot find or read the boot file. You must 
restart the computer and supply a filesystem disk with the boot file 
in the root directory. 


not a directory 

The specified area on the device does not contain a valid UNIX 
filesystem. 


zero length directory 

Although an otherwise valid filesystem was found, it contains a 
directory of apparently zero length. This most often occurs when a 
pre- System V UNIX filesystem (with incorrect, or incompatible 
word ordering) is in the specified area. 
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fload:read(;c)=y 

An attempted read of x bytes of the file returned only y bytes. This 
is probably due to a premature end-of-file. It could also be caused 
by a corrupted file, or incorrect word ordering in the header. 

Files 


/boot 

/etc/default/boot 

/etc/masterboot 

/etc/hdbootO 

/etc/hdbootl 

See Also 


autoboot(ADM), badtrk(ADM), fd(HW), fdisk(ADM), fsck(ADM), 
haltsys(AJDM), hd(HW), init(M), sulogin(ADM) 

Notes 


The computer tries to boot off any diskette in the drive. If the diskette 
does not contain a valid bootstrap program, errors occur. 

The boot program cannot be used to load programs that have not been 
linked for stand-alone execution. To create stand-alone programs, the 
-A option of the UNIX linker (/<i(CP)) and special stand-alone libraries 
must be used. 

Stand-alone programs can operate in real or protected mode, but they 
must not be large or huge models. Programs in real mode can use the 
input/output routines of the computer’s startup ROM. 

RONLYROOT should only be set to YES for installation. If it is set to 
YES during day-to-day operations, it will prevent your making 
changes to the root filesystem. You will then be required to boot from 
the floppy drive, edit the /etc/default/boot file, and reboot. 

Value Added 


boot is an extension of AT&T System V provided by The Santa Cruz 
Operation, Inc. 
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compact disk devices 

Description 

The cdrom devices implement the interface with compact disk drives. 

The character special cd devices (/dev/rcdO, and so forth) support raw 
I/O in multiples of the physical sector size of the CD-ROM (typically 
2048 bytes). 

The block special cd devices (/dev/cdO and so forth) support buffered 
I/O. 

The minor device number determines which compact disk unit will be 
accessed. The correspondence beween the unit number and the SCSI 
host adaptor, controller and lun is defined in the SCSI configuration 
file /etc/conf/cf.d/mscsi. 

Files 


/dev/cd[0-n] 

/dev/rcd[0-n] 

/usr/lib/mkdev/cdrom 

See Also 


scsi(HW), mkdev(ADM) 

Notes 


Because the CD-ROM is a read-only device it is only possible to open 
it for input. 

The command mkdev cdrom can be used to interactively configure the 
CD-ROM driver. 
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cmos 

displays and sets the configuration data base 

Syntax 

cmos [ address [ value ] ] 

Description 


The cmos command displays and/or sets the values in the CMOS con¬ 
figuration data base. This battery-powered data base stores configura¬ 
tion information about the computer that is used at power up to define 
the system hardware configuration and to direct boot procedures. The 
data base is 64 bytes long and is reserved for system operation. Refer 
to your computer hardware manual for more information. 

The cmos command is typically used to alter the current hardware 
configuration when new devices are added to the system. When only 
address is given, the command displays the value at that address, ff 
both address and a value are given, the command assigns the value to 
that address. If no arguments are given, the command displays the 
entire contents of the data base. 

The CMOS configuration data base may also be examined and modi¬ 
fied by reading from and writing to /dev/cmos file. Because success¬ 
ful system operation depends on correct configuration information, the 
data base should be modified by experienced system administrators 
only. 

The computer manufacturer’s diagnostic diskette should be run before 
setting the CMOS data base. 

Files 


/etc/cmos 

/dev/cmos 
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fd_ 

floppy devices 

Description 


The fd devices implement the interface with floppy disk drives. Each 
device name corresponds to a specific major and minor device. Typi¬ 
cally, the tar( C), cpio(C ) or dd( C) commands are used to read or write 
floppy disks. For instance, 

tar tvf /dev/fdO 

tabulates the contents of the floppy disk in drive 0 (zero). 

The block special fd devices are also block-buffered. The floppy 
driver can read or write IK bytes at a time using raw i/o. Note that 
block transfers are always a multiple of the IK disk block size. 

XENIX Devices 


XENIX diskette device file names use the following format: 

/dev/[r]fd[0,l][48ss8,48ss9,96ds9,96dsl5,135ds9,135dsl8] 

(See Notes, below, for more information about device naming pro¬ 
cedure.) The corresponding character special (raw) devices afford 
direct, unbuffered transmission between the floppy and the user’s read 
or write transfer address in the user’s program. 

For information about formatting, seeformat(C). 

The minor device number determines what kind of physical device is 
attached to each device file (see Notes). When accessing the charac¬ 
ter special floppy devices, the user’s buffer must begin on a word 
boundary. The count in a read( S), write (S), or lseek( S) call to a char¬ 
acter special floppy device must be a multiple of IK bytes. 

Device names determine the particular drive and media configuration. 
The device names have the form: 

fd048ds9 

Where: 
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fdO = drive number (0,1,2 or 3) 

48 = number of disk tracks per inch (48 or 96) 
ds = single or double sided floppy (ss or ds) 

9 = number of sectors on the floppy (8 or 9) 

For instance, /dev/fd048ss9 indicates a 48 track per inch, single sided, 
9 sector floppy disk device in drive 0. 

The minor device numbers for floppy drives depend on the drive and 
media configuration. The most common are: 



ds/8 

48tpi 

ds/9 

ss/8 

ss/9 

96tpi 

ds/15 ds/8 

135tpi 

ds/9 ds/18 

Drive 

Minor Device Number 

0 

12 

4 

8 

0 

52 

44 

36 

60 

1 

13 

5 

9 

1 

53 

45 

37 

61 

2 

14 

6 

10 

2 

54 

46 

38 

62 

3* 










* reserved for special, non-floppy devices connected to the floppy 
controller as unit #3. 

The scheme for creating minor device numbers is as follows. When 
interpreted as a binary number, each bit of the minor device number 
represents some aspect of the device/media configuration. 

For example, the minor device number for /dev/fd048ss8 is “8.” 
Interpreted as a binary number, 8 is: 

00001000 

This is how each bit, or binary digit, is significant: 


48tpi - 0 

Sectors per 
Track 

ss - 0 

Drive 

96tpi - 1 

ds - 1 

135tpi - 1 

32 

16 8 

4 

2 1 

0 

0 

1 

0 

0 0 
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Only the last six digits of the number are used in minor device 
identification. The first significant digit is the third from the left. In 
this example, the third digit from the left is zero, thus the device is 
48tpi. The next two digits mean: 


Bi 

ts 

Sectors per 
Track 

16 

8 

0 

0 

9 

0 

1 

8 

1 

0 

15 

1 

1 

18 


The fourth digit tells whether the floppy is single sided (ss - 0) or dou¬ 
ble sided (ds -1). The last two signify the drive number: 


Bits 

Drive 

Number 

2 

1 

0 

0 

0 

0 

1 

1 

1 

0 

2 

1 

1 

3* 


* reserved for special, non-floppy devices connected to the floppy 
controller as unit #3. 


Using this information, you can construct any minor device numbers 
you need. 


UNIX Devices 


UNIX diskette device file names use the following format: 

/dev/[r]dsk/f[0,l][5h,5d9,5d8,5d4,5dl6,5q,3h,3d][t,u] 

where r indicates a raw (character) interface to the diskette, rdsk 
selects the raw device interface and dsk selects the block device inter¬ 
face. 0 or 1 selects the drive to be accessed: fO selects floppy drive 0, 
while fl selects drive 1. The following list describes the format to be 
interacted with: 

5h 5.25" high density diskette (1.2MB). 

5d9 5.25" double density diskette, 9 sectors per track 

(360KB). 

5d8 5.25" double density diskette, 8 sectors per track 

(320KB). 
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5d4 5.25" double density diskette, 4 sectors per track 

(320KB). 

5dl6 5.25" double density diskette, 16 sectors per track 

(320KB). 

5q 5.25" quad density diskette (720KB). 

3h 3.50" high density diskette (1.44MB). 

3d 3.50" double density diskette (720KB). 


Format specification is mandatory when opening the device for for¬ 
matting. However, when accessing a floppy disk for other operations 
(read and write), the format specification field can be omitted. In this 
case, the floppy disk driver will automatically determine the format 
previously established on the diskette and then perform the requested 
operation (for example, cpio -itv</dev/rsdk/fl). 

The last parameter, t or u, selects the partition to be accessed, t 
represents the whole diskette. Without t or u specified, the whole 
diskette except cylinder 0 will be selected, u represents the whole 
diskette except track 0 of cylinder 0. 

Besides the device file naming convention described above, some of 
the formats have alias names that correlate to previous releases. The 
following list describes the formats that have an alias: 


format 

alias 

5h 

ql5d 

5d8 

d8d 

5d9 

d9d 


For example, the device file /dev/rdsk/f0ql5dt is equivalent to 

/dev/rdsk/fOSht. 

Files 


XENIX Devices: 

/dev/[r]fd0 

/dev/[r]fdl 

/dev/[r]fd048 

/dev/[r]fdl48 

/dev/[r]fd048ds8 

/dev/[r]fd!48ds8 


/dev/[r]fd048ss8 

/dev/[r]fdl48ss8 

/dev/[r]fd048ds9 

/dev/[r]fdl48ds9 

/dev/[r]fd048ss9 

/dev/[r]fd!48ss9 


/dev/[r]fd096 

/dev/[r]fdl96 

/dev/[r]fd096ds9 

/dev/[r]fdl96ds9 

/dev/[r] fd096ds 15 

/dev/[r]fd!96dsl5 


/dev/[r]fd0135ds9 
/dev/[r]fdl 135ds9 
/de v/[r]fd0135ds 18 
/dev/[r]fd!135dsl8 
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UNIX Devices: 

/dev/[r]dsk/fO 

/dev/[r]dsk/fOt 

/dev/[r]dsk/f05h 

/dev/[r]dsk/f05ht 

/dev/[r]dsk/f05d9 


Notes 


/dev/[r]dsk/f05d9t 

/dev/[r]dsk/f0fd8 

/dev/[rjdsk/f05d8t 

/dev/[r]dsk/f05d4 

/dev/[r]dsk/f05d4t 


/dev/[r]dsk/f05d 16 
/dev/[r]dsk/f05d 16t 
/dev/[r]dsk/f05q 
/dev/[r]dsk/f05qt 
/dev/[r]dsk/f03h 


/dev/[r]dsk/f03ht 

/dev/[r]dsk/f03d 

/dev/[r]dsk/f03dt 


It is not advisable to format a low density (48tpi) diskette on a high 
density (96tpi or 135tpi) floppy drive. Low density diskettes written 
on a high density drive should be read on high density drives. They 
may or may not be readable on a low density drive. 

Use error-free floppy disks for best results on reading and writing. 
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hd 


internal hard disk drive 


Description 

Block-buffered access to the primary hard disk is provided through the 
following block special files: hdOO, hdOl through hd04, hdOa and 
hdOd, root, and swap. Block-buffered access to the secondary hard 
disk is provided through the following block special files: hdlO, hdll 
through hdl4, hdla. 

hdOO refers to the entire physical disk; hdOl through hd04 refer to the 
fdisk partitions, root refers to the root file system; swap refers to the 
swap area; The block special files access the disks via the system’s 
normal buffering mechanism and may be read and written without 
regard to the size of physical disk records. 

Character special files follow the same naming convention as the 
block special files except that the character special file is prefaced 
with an “r”. For example, the character special file referring to the 
entire physical disk is /dev/rhdOO. 

The following are the names of the fixed disk partitions. Each parti¬ 
tion can be accessed through a block interface, for example 
/dev/hdOl, or through a character (raw) interface, for example 

/dev/rhdOl. 

The above devices follow the XENIX naming convention. Equivalant 
UNIX devices are found in the /dev/dsk (character) and /dev/rdsk 
(raw) directories. In the table that follows, both XENIX UNIX devices 
are shown. XENIX devices extend only to disks located on the first 
controller; beyond this, the UNIX devices shown must be used. 
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Device File Names for Fixed Disks 

First Controller 

Second Controller 


Disk 1 

Disk 2 

Disk 1 

Disk 2 

Partition 

/dev/hdOO 

/dev/rhdOO 

/dev/hdlO 

/dev/rhdlO 

/dev/dsk/4s0 

/dev/rdsk/4s0 

/dev/dsk/5s0 

/dev/rdsk/5s0 

entire disk 

/dev/hdOl 

/dev/rhdOl 

/dev/hdll 

/dev/rhdll 

/dev/dsk/4sl 

/dev/rdsk/4sl 

/dev/dsk/5sl 

/dev/rdsk/5sl 

first partition 

/dev/hd02 

/dev/rhd02 

/dev/hdl2 

/dev/rhdl2 

/dev/dsk/4s2 

/dev/rdsk/4s2 

/dev/dsk/5s2 

/dev/rdsk/5s2 

second partition 

/dev/hd03 

/dev/rhd03 

/dev/hdl3 

/dev/rhdl3 

/dev/dsk/4s3 

/dev/rdsk/4s3 

/dev/dsk/5s3 

/dev/rdsk/5s3 

third partition 

/dev/hd04 

/dev/rhd04 

/dev/hdl4 

/dev/rhdl4 

/dev/dsk/4s4 

/dev/rdsk/4s4 

/dev/dsk/5s4 

/dev/rdsk/5s4 

fourth partition 

/dev/hdOa 

/dev/rhdOa 

/dev/hdla 

/dev/rhdla 

/dev/dsk/4sa 

/dev/rdsk/4sa 

/dev/dsk/5sa 

/dev/rdsk/5sa 

active partition 

/dev/hdOd 

/dev/rhdOd 

/dev/hdld 

/dev/rhdld 

/dev/dsk/4sd 

/dev/rdsk/4sd 

/dev/dsk/5sd 

/dev/rdsk/5sd 

DOS partition 

/dev/root 

/dev/rroot 


root file system 

/dev/swap 

/dev/rswap 


swap area 


Note that the root and swap file exist only for the root disk. 

To access DOS partitions, specify letters such as “C:” or “D:” to 
indicate first or second partitions. The file /etc/default/msdos con¬ 
tains lines that assign a letter abbreviation for the DOS device name. 
Refer to dos(C). 

The following table lists the minor device number definitions for the 
hard disk special files, along with examples. Note that the block and 
character special devices share the same minor device definition. The 
minor device number definition is as follows: bits 7 and 6 denote phy¬ 
sical drive, bits 5-3 denote virtuaMfdisk) partition and bits 2-0 denote 
divvy partition. 
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Minor Device Bits 

Phys. 

Virtual 

divvy 

Device special 

Description 

7 6 

5 4 3 

2 1 0 

file name 


0 0 

0 0 0 

0 0 0 

/dev/hd00 

whole PD 0 

0 1 

0 0 0 

0 0 0 

/dev/hdlO 

whole PD 1 

1 0 

0 0 0 

0 0 0 

/dev/dsk/4s0 

whole PD 2 

1 1 

0 0 0 

0 0 0 

/dev/dsk/5s0 

whole PD 3 

0 0 

0 0 1 

1 1 1 

/dev/hd01 

PD 0, whole VD 1 

0 0 

0 1 0 

1 1 1 

/dev/hd02 

PD 0, whole VD 2 

0 0 

0 1 1 

1 1 1 

/dev/hd03 

PD 0, whole VD 3 

0 0 

1 0 0 

1 1 1 

/dev/hd04 

PD 0, whole VD 4 

0 0 

1 0 1 

1 1 1 

/dev/hdOa 

PD 0, whole active VD 

0 0 

1 1 0 

1 1 1 

/dev/hdOd 

PD 0, whole DOS VD 

0 0 

1 0 1 

0 0 0 

/dev/root 

PD 0, active virtual, DP 0 

0 0 

1 0 1 

0 0 1 

/dev/swap 

PD 0, active virtual, DP 1 

0 0 

1 0 1 

0 1 0 

/dev/usr 

PD 0, active virtual, DP 2 

0 0 

1 0 1 

1 1 0 

/dev/recover 

PD 0, active virtual, DP 6 

0 1 

0 0 1 

1 1 1 

/dev/hdll 

PD 1, whole VD 1 

0 1 

0 1 0 

1 1 1 

/dev/hdl2 

PD 1, whole VD 2 

0 1 

0 1 1 

1 1 1 

/dev/hdl3 

PD 1, whole VD 3 

0 1 

1 0 0 

1 1 1 

/dev/hdl4 

PD 1, whole VD4 

0 1 

1 0 1 

1 1 1 

/dev/hdla 

PD 1, whole active VD 

0 1 

1 1 0 

1 1 1 

/dev/hdld 

PD 1, whole DOS VD 

0 1 

1 0 1 

0 0 0 

/dev/u0 

PD 1, active virtual, DP 0t 

0 1 

1 0 1 

0 0 1 

/dev/ul 

PD 1, active virtual, DP It 

0 1 

1 0 1 

0 1 0 

/dev/u2 

PD 1, active virtual, DP 2t 

1 1 

0 0 1 

1 1 1 

/dev/dsk/4sl 

PD 2, whole VD 1 

1 1 

0 1 0 

1 1 1 

/dev/dsk/4s2 

PD 2, whole VD 2 

1 1 

0 1 1 

1 1 1 

/dev/dsk/4s3 

PD 2, whole VD 3 

1 1 

1 0 0 

1 1 1 

/dev/dsk/4s4 

PD 2, whole VD 4 

1 1 

1 0 1 

1 1 1 

/dev/dsk/4sa 

PD 2, whole active VD 

1 1 

1 1 0 

1 1 1 

/dev/dsk/4sd 

PD 2, whole DOS VD 

1 1 

0 0 1 

1 1 1 

/dev/dsk/5sl 

PD 3, whole VD 1 

1 1 

0 1 0 

1 1 1 

/dev/dsk/5s2 

PD 3, whole VD 2 

1 1 

0 1 1 

1 1 1 

/dev/dsk/5s3 

PD 3, whole VD 3 

1 1 

1 0 0 

1 1 1 

/dev/dsk/5s4 

PD 3, whole VD 4 

1 1 

1 0 1 

1 1 1 

/dev/dsk/5sa 

PD 3, whole active VD 

1 1 

1 1 0 

1 1 1 

/dev/dsk/5sd 

PD 3, whole DOS VD 

KEY 

VD = virtual drive 

PD = physical drive 


DP = divvy partition 

t = user-defined name 


The device files usr and u[0-2] are optional filesystem names; these 
nodes are not present unless created by the system administrator. 
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Files 


/dev/hdOa 

/dev/rhdOa 

/dev/hd0[0-4] 

/dev/rhd0[0-4] 

/dev/hdOd 

/dev/rhdOd 

/dev/dsk/4s0 

/dev/dsk/5s0 

/dev/dsk/4sl 

/dev/dsk/4s2 

/dev/dsk/4s3 


/dev/hdla 
/dev/rhdla 
/dev/hdl[0-4] 
/dev/rhdl [0-4] 
/dev/hdld 
/dev/rhdld 
/dev/dsk/4s4 
/dev/dsk/4sa 
/dev/dsk/4sd 
/dev/dsk/5sl 
/dev/dsk/5s2 


/dev/usr 

/dev/rusr 

/dev/root 

/dev/rroot 

/dev/swap 

/dev/rswap 

/dev/dsk/5s3 

/dev/dsk/5s4 

/dev/dsk/5sa 

/dev/dsk/5sd 


See Also 


fdisk(ADM), badtrk(ADM), divvy(ADM), dos(C), mkdev(ADM) 

Diagnostics 


The following messages are among those that may be printed on the 
console: 

invalid fixed disk parameter table 
and: 

error on fixed disk (minor n ), block = nnnnn, 
cmd -nnnnn, status -nnnn. 

Sector = nnnnn, Cylinder/head = nnnnn 

Possible reasons for the first error include: 

The kernel is unable to get drive specifications, such as number of 
heads, cylinders, and sectors per track, from the disk controller 
ROM. 

- Improper configuration. 

- The disk is not turned on. 

The disk is not supported. 

The second error specifies the following information: 

- block : The UNIX block number within the device. 
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cmd: The last command sent to the disk controller. 

- status : The error status from the disk controller. 

- Sector and Cylinder/head specify the location of a possible flaw. 
This information is used with badtrk( ADM). 

Notes 


On the first disk, hdOO denotes the entire disk and is used to access the 
master boot block which includes the fdisk partition table. For the 
second disk, hdlO denotes the entire disk and is used to access its 
fdisk partition table. Do not write to hdlO and hdOO. 
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keyboard 

the PC keyboard 

Description 


The PC keyboard is used to enter data, switch screens, and send cer- 
tain control signals to the computer. The Operating System performs 
terminal emulation on the PC screen and keyboard, and, in doing so, 
makes use of several particular keys and key combinations. These 
keys and key combinations have special names that are unique to 
UNIX systems, and may or may not correspond to the keytop labels on 
your keyboard. These keys are described later. 

When you press a key, one of the following happens: 

- An ASCII value is entered 

- A string is sent to the computer. 

- A function is initiated. 

- The meaning of another key, or keys, is changed. 

WTien a key is pressed (a keystroke), the keyboard sends a scancode to 
the computer, it is interpreted by the keyboard driver. The interpreta¬ 
tion of key codes may be modified so that keys can function dif¬ 
ferently from their default actions. 

There are three special occurrences, or keystrokes: 

- Switch screens. 

- Send signals. 

- Change the value of previous character, characters or string. 


Switching Screens (Multiscreen) 


To get to the next consecutive screen, enter Ctrl-PrtSc using the Ctrl 
key, and the PrtSc key. Any active screen may be selected by enter¬ 
ing alt-F/z, where Fn is one of the function keys. FI refers to the PC 
display (/dev/ttyOl). 
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Signals 

A signal affects some process or processes. Examples of signals are 
Ctrl-d (end of input, exits from shell), CtrlA (quits a process), Ctrl-s 
(stop output to the screen), and Ctrl-q (resume sending output). 

Typically, characters are mapped to signals using stty(C). The only 
way to map signals is using stty. 

Altering Values 


The actual code sent to the keyboard driver can be changed by using 
certain keys in combination. For example, the SHIFT key changes the 
ASCII values of the alphanumeric keys. Holding down the Ctrl key 
while pressing another key sends a control code (Ctrl-d, Ctrl-s, 
Ctrl-q, etc.). 

Special Keys 


To help you find the special keys, the following table shows which 
keys on a typical console correspond to UNIX system keys. In this 
table, a hyphen (-) between keys means ‘hold down the first key while 
pressing the second.’ 


UNIX Name 

Keytop 

Action 

INTO 

Del 

Stops current action and returns 
to the shell. This key is also 
called the RUB OUT or INTER¬ 
RUPT key. 

BACKSPACE 

< 7 - 

Deletes the first character to 
the left of the cursor. 

Note that the “cursor left” key 
also has a left arrow (<—) on its 
keytop, but you cannot back¬ 
space using that key. 

Ctrl-d 

Ctrl-d 

Signals the end of input from 
the keyboard; also exits current 
shell. 

Ctrl-h 

Ctrl-h 

Deletes the first character to 
the left of the cursor. Also 
called the ERASE key. 

Ctrl-q 

Ctrl-q 

Restarts printing after it has 
been stopped with Ctrl-s. 
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UNIX Name 

Keytop 

Action 

Ctrl-s 

Ctrl-s 

Suspends printing on the screen 
(does not stop the program). 

Ctrl-u 

Ctrl-u 

Deletes all characters on the 
current line. Also called the 
KILL key. 

Ctrl-\ 

CtrlA 

Quits current command and 
creates a core file, if allowed. 
(Recommended for debugging 
only.) 

ESCAPE 

Esc 

Special code for some pro¬ 
grams. For example, changes 
from insert mode to command 
mode in the v/(C) text editor. 

RETURN 

(down-left arrow 
or ENTER) 

Terminates a command line and 
initiates an action from the 
shell. 

F n 

F h 

Function key n. F1-F12 are 
unshifted, F13-F24 are shifted 
F1-F12, F25-F36 are Ctrl-Fl 
through F12, and F37-F48 are 
Ctrl-Shift-Fl through F12. 



The next Fn keys (F49-F60) are 
on the number pad (unshifted): 



F49 - ’7’ F55 - ’6’ 

F50 - ’8’ F56 - V 

F51 - ’9’ F57 - 9 1 9 

F52 - F58 - ’2’ 

F53 - ’4’ F59 - ’3’ 

F54 - ’5’ F60 - ’O’ 



For keys F61 through F96, see 
/usr/Iib/keyboard/strings. 

These function keys are not 
available on all keyboards, but 
you can map other keys to 
represent them. 


The keyboard mapping is performed through a structure defined in 
/usr/include/sys/keyboard.h. Each key can have ten states. The first 
eight are: 


- Base - Ctrl-Shift 

- Shift - Alt-Shift 

- Ctrl - Alt-Ctrl 

- Alt - Alt-Ctrl-Shift 
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There are two additional states indicated by two special bytes. The 
first is a “special state” byte whose bits indicate whether the key is 
“special’ ’ in one or more of the first eight states. 

The second is one of four characters (C, N, B, O) which indicate how 
the lock keys affect the particular key. This is discussed further in the 
next section, “Scan Codes.” 

Keyboard Mode_ 


Most keyboards normally are in a PC compatibility mode, though 
some can be put into a native AT keyboard mode. The UNIX utility 
kbmode( ADM) can be used to determine if a keyboard supports AT 
mode, and can also be used to put the keyboard into AT mode until the 
next time the system is rebooted. A system can also be configured to 
boot with the keyboard in AT mode with the configure(ADM) utility. 

Enhanced keyboards are more fully programmable in AT mode. Also, 
it recognizes two control keys and an alt key. 

Scan Codes 


The following table describes the default contents of 
/usr/lib/keyboard/keys. The column headings are: 

SCAN CODE - The scan code generated by the keyboard hardware 
when a key is pressed. There is no user access to the scan code gen¬ 
erated by releasing a key. 

BASE - The normal value of a key press. 

SHIFT - The value of a key press when the SHIFT is also being held 
down. 

LOCK - Indicates which lock keys affect that particular key: 

- C indicates Capslock 

- N indicates Numlock 

- B indicates both 

- O indicates locking is off 

Keys affected by the lock keys C, B, or N, send the shifted value (scan 
code) of current state when that lock key is on. When the shift key is 
depressed while a lock key is also on, the key reverts (toggles) to its 
original state. 

The other columns are the values of key presses when combinations of 
the CTRL, ALT and SHIFT keys are also held down. 
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All values, except for keywords, are ASCII character values. The key¬ 
words refer to the special function keys. 


ALT 

SCAN CTRL ALT ALT CTRL 

CODE BASE SHIFT CTRL SHIFT ALT SHIFT CTRL SHIFT LOCK 


0 

nop 

nop 

nop 

nop 

1 

esc 

esc 

nop 

nop 

2 

t 

»!* 

nop 

nop 

3 

*2* 


nop 

nop 

4 

*3* 


nop 

nop 

5 

*4* 

T 

nop 

nop 

6 

*5* 


nop 

nop 

7 

’6’ 

*** 

rs 

rs 

8 

f T 


nop 

nop 

9 

’8’ 

»*» 

nop 

nop 

10 

’9’ 

T 

nop 

nop 

11 

’O’ 

y 

nop 

nop 

12 

* 9 


ns 

ns 

13 

’=’ 


nop 

nop 

14 

bs 

bs 

del 

del 

15 

ht 

btab 

nop 

nop 

16 

’q’ 

’Q’ 

del 

del 

17 

’w’ 

’W’ 

etb 

etb 

18 

V 

’E’ 

enq 

enq 

19 

Y 

’R’ 

dc2 

dc2 

20 

Y 

T* 

dc4 

dc4 

21 

y 

•Y’ 

em 

em 

22 

V 

’U’ 

nak 

nak 

23 

Y 

T 

ht 

ht 

24 

’o’ 

’O’ 

si 

si 

25 

V 

*P* 

die 

die 

26 

T 

T 

esc 

esc 

27 

T 

T 

gs 

gs 

28 

cr 

cr 

nl 

nl 

29 

Ctrl 

Ctrl 

Ctrl 

Ctrl 

30 

V 

’A’ 

soh 

soh 

31 

’s’ 

’S’ 

dc3 

dc3 

32 

’d’ 

’D’ 

eot 

eot 

33 

T 

’F 

ack 

ack 

34 

’g’ 

’G’ 

bel 

bel 

35 

’h’ 

’H* 

bs 

bs 

36 

T 

T 

nl 

nl 

37 

’k’ 

’K’ 

vt 

vt 

38 

T 

*L’ 

np 

np 

39 

V 


nop 

nop 

40 

V 

,tl, 

nop 

nop 

41 

»<» 

9~9 

nop 

nop 
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nop 

nop 

nop 

nop 

0 

esc 

esc 

nop 

nop 

0 

•r 

T 

nop 

nop 

0 

’2’ 

w 

nop 

nop 

0 

*3* 


nop 

nop 

0 

*4* 

T 

nop 

nop 

O 

*5* 


nop 

nop 

0 

*6* 


rs 

rs 

O 

’7’ 


nop 

nop 

O 

’8’ 

>*> 

nop 

nop 

O 

*9* 


nop 

nop 

0 

’O’ 


nop 

nop 

0 

9 9 

_ 

ns 

ns 

O 

9^9 

V 

nop 

nop 

0 

bs 

bs 

del 

del 

0 

ht 

btab 

nop 

nop 

0 

’q’ 

’Q* 

del 

del 

C 

’w’ 

*W’ 

etb 

etb 

C 

V 

’E* 

enq 

enq 

C 

*r* 

’R’ 

dc2 

dc2 

C 

*t* 

T’ 

dc4 

dc4 

C 

y 

•Y’ 

em 

em 

C 

’u* 

•u* 

nak 

nak 

C 

*i* 

T 

ht 

ht 

c 

’o’ 

’O’ 

si 

si 

c 

V 

*P* 

die 

die 

c 

T 


esc 

esc 

0 

T 

T’ 

gs 

gs 

0 

cr 

cr 

nl 

nl 

0 

Ctrl 

Ctrl 

Ctrl 

Ctrl 

0 

’a’ 

’A’ 

soh 

soh 

c 

V 

’S’ 

dc3 

dc3 

c 

*d’ 

TT 

eot 

eot 

c 

T 

*F 

ack 

ack 

c 

y 

*G* 

bel 

bel 

c 

’h* 

’H’ 

bs 

bs 

c 


T 

nl 

nl 

c 

*k* 

’K* 

vt 

vt 

c 

T 


np 

np 

c 



nop 

nop 

0 

V’ 

»«» 

nop 

nop 

0 

919 


nop 

nop 

o 
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SCAN 

CODE BASE 

42 lshift 

43 ■V 

44 V 

45 ’x’ 

46 ’c* 

47 V 

48 ’b’ 

49 ’n’ 

50 ’m’ 

51 V 

52 V 

53 T 

54 rshift 

55 

56 alt 

57 • ’ 

58 clock 

59 fkeyl 

60 fkey2 

61 fkey3 

62 fkey4 

63 fkey5 

64 fkey6 

65 fkey7 

66 fkey8 

67 fkey9 

68 fkeylO 

69 nlock 

70 slock 

71 fkey49 

72 fkey50 

73 fkey51 

74 fkey52 

75 fkey53 

76 fkey54 

77 fkey55 

78 fkey56 

79 fkey57 

80 fkey58 

81 fkey59 

82 fkey60 

83 del 

84 nop 

85 fkeyll 

86 fkeyl 2 


SHIFT CTRL 


lshift 

lshift 

T 

fs 

Z’ 

sub 

X’ 

can 

’C’ 

etx 

’V’ 

syn 

’B’ 

stx 

'N* 

so 

’M’ 

cr 


nop 

V 

nop 


nop 

rshift 

rshift 

»*» 

nscr 

alt 

alt 

clock 

clock 

fkeyl 3 

fkey25 

fkeyl4 

fkey26 

fkeyl5 

fkey27 

fkeyl 6 

fkey28 

fkeyl7 

fkey29 

fkeyl 8 

fkey30 

fkeyl 9 

fkey31 

fkey 20 

fkey32 

fkey 21 

fkey33 

fkey 22 

fkey34 

nlock 

dc3 

slock 

del 


, 7 , 

’ 8 ’ 

’ 8 * 

’9’ 

’9’ 

’4’ 

’4’ 

’5’ 

*5’ 

’ 6 ’ 

’ 6 ’ 

’+• 

V 

’ 1 ’ 

•r 

’ 2 ’ 

* 2 * 

*3* 

, 3 , 

’O’ 

’O’ 

y y 

del 

nop 

nop 

fkey23 

fkey35 

fkey24 

fkey36 


CTRL 

SHIFT ALT 


lshift 

lshift 

fs 

’NY 

sub 

V 

can 

’x’ 

etx 

’c’ 

syn 

V 

stx 

*b’ 

so 

’n’ 

cr 

’m’ 

nop 

7 

nop 

V 

nop 

7 

rshift 

rshift 

nscr 

>*> 

alt 

y y 

alt 

clock 

clock 

fkey37 

scrl 

fkey38 

scr 2 

fkey39 

scr3 

fkey40 

scr4 

fkey41 

scr5 

fkey42 

scr 6 

fkey43 

scr7 

fkey44 

scr 8 

fkey45 

scr9 

fkey46 

scrlO 

dc3 

nlock 

del 

slock 

, 7 , 

, 7 , 

’ 8 * 

* 8 * 

*9* 

’9’ 

’4’ 

’4’ 

’5’ 

*5* 

* 6 * 

’ 6 ’ 


V 

•r 

’V 

’ 2 ’ 

’ 2 ’ 

, 3 , 

*3* 

’ 0 ’ 

’O’ 

del 

del 

nop 

nop 


fkey47 scrll 
fkey48 scrl2 


ALT 

SHIFT 

ALT 

CTRL 

lshift 

lshift 

V 

fs 

•Z’ 

sub 

X’ 

can 

’C’ 

etx 

’V’ 

syn 

’B’ 

stx 

’N’ 

so 

*M’ 

cr 


nop 


nop 


nop 

rshift 

rshift 


nscr 

alt 

alt 

clock 

clock 

scrll 

scrl 

scrl 2 

scr 2 

scrl 3 

scr3 

scrl 4 

scr4 

scrl 5 

scr5 

scrl 6 

scr 6 

scr7 

scr7 

scr 8 

scr 8 

scr9 

scr9 

scrlO 

scrlO 

nlock 

dc3 

slock 

del 

'T 

, 7 , 

*8* 

*8* 

’9’ 

*9* 

y y 

*4* 

’4’ 

’5* 

’5’ 

’ 6 ’ 

’ 6 ’ 

V 

V 

•r 

* 1 * 

*2* 

’2’ 

, 3 , 

*3* 

’O’ 

’0* 

del 

del 

nop 

nop 

scrll 

scrll 

scrl 2 

scrl 2 


ALT 

CTRL 

SHIFT LOCK 

lshift O 

fs O 

sub C 

can C 

etx C 

syn C 

stx C 

so C 

cr C 

nop O 

nop O 

nop O 

rshift O 

nscr O 

alt O 

’ ’ O 

clock O 

scrl 1 O 

scrl 2 O 

scrl3 O 

scrl4 O 

scrl 5 O 

scrl 6 O 

scr7 O 

scr 8 O 

scr9 O 

scrlO O 

dc3 O 

del O 

’7’ N 

* 8 ’ N 

’9’ N 

N 

’4’ N 

*5’ N 

’ 6 ’ N 

V N 

*r n 

*2’ N 

•3’ N 

’0’ N 

del N 

nop O 

scrll O 

scrl 2 O 
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The following scan codes exist only for keyboards which support, and 
are in, native AT mode rather than PC compatibility mode. 


ALT 


SCAN 

CODE 

BASE 

SHIFT 

CTRL 

CTRL 

SHIFT 

ALT 

ALT 

SHIFT 

ALT 

CTRL 

CTRL 

SHIFT 

LOCK 

87 

fkeyll 

fkey23 

fkey35 

fkey47 

scrll 

scrll 

scrll 

scrll 

O 

88 

fkeyl2 

fkey24 

fkey36 

fkey48 

scrl2 

scrl2 

scrl2 

scrl2 

O 

89 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

O 

90 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

O 

91 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

O 

92 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

O 

93 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

O 

94 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

O 

95 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

O 

96 

fkey50 

fkey50 

fkey50 

fkey50 

fkey50 

fkey50 

fkey50 

fkey50 

O 

97 

fkey53 

fkey53 

fkey53 

fkey53 

fkey53 

fkey53 

fkey53 

fkey53 

O 

98 

fkey58 

fkey58 

fkey58 

fkey58 

fkey58 

fkey58 

fkey58 

fkey58 

O 

99 

fkey55 

fkey55 

fkey55 

fkey55 

fkey55 

fkey55 

fkey55 

fkey55 

O 

100 

fkey49 

fkey49 

fkey49 

fkey49 

fkey49 

fkey49 

fkey49 

fkey49 

O 

101 

fkey51 

fkey51 

fkey51 

fkey51 

fkey51 

fkey51 

fkey51 

fkey51 

O 

102 

fkey57 

fkey57 

fkey57 

fkey57 

fkey57 

fkey57 

fkey57 

fkey57 

O 

103 

fkey59 

fkey59 

fkey59 

fkey59 

fkey59 

fkey59 

fkey59 

fkey59 

O 

104 

fkey60 

fkey60 

fkey60 

fkey60 

fkey60 

fkey60 

fkey60 

fkey60 

O 

105 

del 

del 

del 

del 

del 

del 

del 

del 

N 

106 

fkey54 

fkey54 

fkey54 

fkey54 

fkey54 

fkey54 

fkey54 

fkey54 

O 

107 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

O 

108 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

109 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

o 

110 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

111 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

112 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

113 

nop 

nop 

nop ♦ 

nop 

nop 

nop 

nop 

nop 

0 

114 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

115 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

116 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

o 

117 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

. nop 

o 

118 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

o 

119 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

o 

120 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

121 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

122 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

o 

123 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

124 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

o 

125 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 


March 15, 1989 KEYBOARD-7 






KEYBOARD (HW) 


KEYBOARD (HW) 


ALT 

SCAN CTRL ALT ALT CTRL 


CODE 

BASE 

SHIFT 

CTRL 

SHIFT 

ALT 

SHIFT 

CTRL 

SHIFT 

LOCK 

126 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

127 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

nop 

0 

128 

rctrl 

rctrl 

rctrl 

rctrl 

rctrl 

rctrl 

rctrl 

rctrl 

0 

129 

ralt 

ralt 

ralt 

ralt 

ralt 

ralt 

ralt 

ralt 

0 

130 

fkey60 

fkey60 

fkey60 

fkey60 

fkey60 

fkey60 

fkey60 

fkey60 

O 

131 

del 

del 

del 

del 

del 

del 

del 

del 

N 

132 

fkey49 

fkey49 

fkey49 

fkey49 

fkey49 

fkey49 

fkey49 

fkey49 

0 

133 

fkey57 

fkey57 

fkey57 

fkey57 

fkey57 

fkey57 

fkey57 

fkey57 

O 

134 

fkey51 

fkey51 

fkey51 

fkey51 

fkey51 

fkey51 

fkey51 

fkey51 

o 

135 

fkey59 

fkey59 

fkey59 

fkey59 

fkey59 

fkey59 

fkey59 

fkey59 

0 

136 

fkey53 

fkey53 

fkey53 

fkey53 

fkey53 

fkey53 

fkey53 

fkey53 

0 

137 

fkey55 

fkey55 

fkey55 

fkey55 

fkey55 

fkey55 

fkey55 

fkey55 

o 

138 

fkey50 

fkey50 

fkey50 

fkey50 

fkey50 

fkey50 

fkey50 

fkey50 

0 

139 

fkey58 

fkey58 

fkey58 

fkey58 

fkey58 

fkey58 

fkey58 

fkey58 

0 

140 

T 

nop 

nop 

nop 

r 

nop 

nop 

nop 

0 

141 

cr 

cr 

nl 

nl 

cr 

cr 

nl 

nl 

0 


The next table lists the “value” of each of the special keywords used 
in /usr/lib/keyboard/keys (and the preceding table). mapkey( M) 
places a “value” in the ioctl buffer during key mapping. The key¬ 
words are only used in the scan code file (/usr/lib/keyboard/keys) for 
readability. 


Name 

Value 

Meaning 

nop 

0 

No operation - no action from keypress 

lshift 

2 

Left hand shift 

rshift 

3 

Right hand shift 

clock 

4 

Caps lock 

nlock 

5 

Numeric lock 

slock 

6 

Scroll lock 

alt 

7 

Alt key 

btab 

8 

Back tab key - generates fixed sequence (esc [ Z) 

Ctrl 

9 

Control key 

nscr 

10 

Switch to die next screen 

scrl 

11 

Switch to screen #1 

scrl6 

26 

Switch to screen #16 

fkeyl 

27 

Function key #1 

fkey96 

122 

Function key #96 

rctl 

128* 

Right Control Key 

ralt 

129* 

Right Alt Key 


* AT mode keyboard only. 
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This table lists names and decimal values that are interchangeable in 
the mapkey file. Names are used in place of numeric constants to 
make it easier to read the scan code table. Again, only the decimal 
values are placed in the ioctl buffer. These are taken from ascii(M). 


Name 

Value 

Name 

Value 

nul 

0 

del 

17 

soh 

1 

dc2 

18 

stx 

2 

dc3 

19 

etx 

3 

dc4 

20 

eot 

4 

nak 

21 

enq 

5 

syn 

22 

ack 

6 

etb 

23 

bel 

7 

can 

24 

bs 

8 

em 

25 

ht 

9 

sub 

26 

nl 

10 

esc 

27 

vt 

11 

fs 

28 

np 

12 

gs 

29 

cr 

13 

rs 

30 

so 

14 

ns 

31 

si 

15 

del 

127 

die 

16 




Keyboard Mapping 


The PC keyboard is mapped as part of terminal emulation. This kind 
of mapping is performed only on the computer keyboard, not on 
remote terminals. Use mapkey to change keyboard mapping. To 
change the mapping for individual channels (multiscreens), use 
mapchan(M). 

Keyboard mapping can also be performed using ioctl . The syntax is 
the same as for string key mapping (see previous section). 

For keyboard mapping, cmd is GIO_KEYMAP to display the current 
map, and PIO_KEYMAP puts the prepared buffer into place. 

String Key Mapping 


To map string (function) keys, use the mapstr (see mapkey( M)) utility. 
mapstr modifies the string mapping table where function keys are 
defined. 

The string mapping table is an array of 512 bytes (typedef strmapj) 
containing null terminated strings that redefine the function keys. The 
first null terminated string is assigned to the first string key, the 
second string to the second string key, and so on. 
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There is no limit to the length of any particular string as long as the 
whole table does not exceed 512 bytes, including nulls. Strings are 
made null by the introduction of extra null characters. 

The following is a list of default function key values: 



Default Function Key Values 

Key Number Function Key 

Function 

1 

FI 

ESC [M 

2 

F2 

ESC [N 

3 

F3 

ESC [0 

4 

F4 

ESC [P 

5 

F5 

ESC [Q 

6 

F6 

ESC [R 

7 

F7 

ESC [S 

8 

F8 

ESC [T 

9 

F9 

ESC[U 

10 

F10 

ESC [V 

11 

Fll 

ESC [W 

12 

F12 

ESC[X 

13 

Shift-Fl 

ESC [Y 

14 

Shift-F2 

ESC [Z 

15 

Shift-F3 

ESC [a 

16 

Shift-F4 

ESC [b 

17 

Shift-F5 

ESC [c 

18 

Shift-F6 

ESC [d 

19 

Shift-F7 

ESC [e 

20 

Shift-F8 

ESC [f 

21 

Shift-F9 

ESC [g 

22 

Shift-FlO 

ESC [h 

23 

Shift-Fl 1 

ESC [i 

24 

Shift-F12 

ESC [j * 

25 

Ctrl-Fl 

ESC [k 

26 

Ctrl-F2 

ESC [1 

27 

Ctrl-F3 

ESC [m 

28 

Ctrl-F4 

ESC [n 

29 

Ctrl-F5 

ESC [o 

30 

Ctrl-F6 

ESC [p 

31 

Ctrl-F7 

ESC [q 

32 

Ctrl-F8 

ESC [r 

33 

Ctrl-F9 

ESC [s 

34 

Ctrl-FlO 

ESC [t 

35 

Ctrl-Fl 1 

ESC [u 

36 

Ctrl-F12 

ESC [v 
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Default Function Key Values (continued) 

Key Number Function Key 

Function 

37 

Ctrl-Shift-Fl 

ESC [w 

38 

Ctrl-Shift-F2 

ESC [x 

39 

Ctrl-Shift-F3 

ESC [y 

40 

Ctrl-Shift-F4 

ESC[z 

41 

Ctrl-Shift-F5 

ESC [@ 

42 

Ctrl-Shift-F6 

ESC [[ 

43 

Ctrl-Shift-F7 

ESC [\ 

44 

Ctrl-Shift-F8 

ESC [] 

45 

Ctrl-Shift-F9 

ESC [„ 

46 

Ctrl-Shift-FlO 

ESC [ 

47 

Ctrl-Shift-Fl 1 

ESC [‘ 

48 

Ctrl-Shift-F12 

ESC [{ 

49 

Home 

ESC [H 

50 

Up arrow 

ESC [A 

51 

Page up 

ESC [I 

52 

Minus sign 

- 

53 

Left arrow 

ESC [D 

54 

5 

ESC [E 

55 

Right arrow 

ESC [C 

56 

Plus sign 

+ 

57 

End 

ESC [F 

58 

Down arrow 

ESC[B 

59 

Page down 

ESC [G 

60 

Insert 

ESC [L 


You can also map string keys using ioctl (S). The syntax is: 

#include <sys/keyboard.h> 
ioctl(fd,cmd,buf) 
int fd, cmd; 
char *buf; 


For string key mapping where cmd is GIO_STRMAP to display the 
string mapping table and PIO_STRMAP to put the new string mapping 
table in place. 
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/usr/lib/keyboard/keys 

/usr/lib/keyboard/strings 

See Also 


mapchan(F), mapchan(M), mapkey(M), multiscreen(M), screen(HW), 
setkey(C), stty(C), kbmode(ADM), configure(ADM) 
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Ip, IpO, Ipl, Ip2 

line printer device interfaces 

Description 


The IpO , Ipl, and lp2 files provide access to the optional parallel 
ports of the computer. The IpO and lp2 files provide access to parallel 
ports 1 and 2, respectively. The Ipl file provides access to the parallel 
port on the monochrome adaptor. 

Only one of IpO and Ipl may be used on a given system. To access two 
parallel printers on a system, use either IpO or •pi, and lp2. 

Files 


/dev/lpO 

/dev/lpl 

/dev/lp2 

See Also 


lp(C), lpadmin(ADM), lpsched(ADM) 

Notes 


The standard lp ports, IpO, Ipl, and lp2 send a printer initialization 
string the first time the file is opened after the system is booted. 

Not all computers have an alternate parallel port slot. 
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machine 

description of host machine 


Description 


This page lists the internal characteristics of personal computers 
which use the Intel 8086 processor family and its associated hardware. 
The information is intended for software developers who wish to 
transfer relocatable object or executable files from other machines to 
a personal computer then prepare the files for execution on the per¬ 
sonal computer. 

Central Processing Unit 

Intel 80386 

Disk Block Size (BSIZE) 

1024 bytes 

Memory Management Scheme 

Segmented and paged (80386) 

Split Instruction and Data 

Supported 

Variable Stack Size 

Supported 

Fixed Stack Size 

Supported 

Clock Ticks 

.02 second 

Binary Compatibility 



The small and middle model binary programs created by the C com¬ 
piler cc(CP) run on many processors. The following chart shows 
which XENIX systems running on which processors produce code exe¬ 
cutable on other machines. It is assumed that system specific system 
calls are not used to produce portable code. cc(CP) produces code by 
default, but can also be used as a cross development compiler, by 
using the appropriate flags. 

SCO -nn is XENIX distributed by The Santa Cruz Operation, Inc. MS- 
nn is XENIX distributed by Microsoft Corporation. Intel UNIX is dis¬ 
tributed by Intel Corporation. Aitos UNIX is distributed by Altos 
Computer Systems, nn designates the machine processor. System 
designates the version of XENIX, either 2.3,3.0, or System V. 
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Binary Compatibility 

Your 

Default compiler 

Runs default 

Compiles (cross 

System 

produces programs 

programs 

development) 


which run on 

created on 

programs for 

Processor 

System/Processor 

System/Processor 

System/Processor 

SCO-86 3.0 

SCO-86 [3.0, Sys V] 

SCO-86 3.0 

DOS* 


SCO-186 [3.0, Sys V] 

SCO-186 3.0 



SCO-286 SysV 

Intel, Altos-86 2.3, 3.0 


SCO-86 SystemV 

SCO-86 Sys V 

SCO-86 [3.0, Sys V] 

MS-286 3.0t 


SCO-186 SysV 

SCO-186 [3.0, Sys V] 

DOS* 


SCO-286 Sys V 

SCO-286 Sys V 



MS-286 Sys V 

Intel, Altos-86 2.3, 3.0 


SCO-186 3.0 

SCO-86 [3.0, Sys V] 

SCO-86 3.0 

DOS* 


SCO-186 [3.0, Sys V] 

SCO-186 3.0 



SCO-286 Sys V 

Intel, Altos-86 2.3, 3.0 


SCO-186 System V 

SCO-86 Sys V 

SCO-86 [3.0, Sys V] 

MS-286 3.0t 


SCO-186 SysV 

SCO-186 [3.0, Sys V] 

DOS* 


SCO-286 Sys V 

SCO-286 Sys V 



MS-286 Sys V 

Intel, Altos-86 2.3, 3.0 


SCO-286 3.0 

SCO-286 [3.0, Sys V] 

SCO-286 3.0 

DOS* 


MS-286 [3.0t, Sys V] 

MS-286 3.0t 


SCO-286 System V 

SCO-86 Sys V 

SCO-86 [3.0, Sys V] 

SCO-286 3.0 


SCO-186 SysV 

SCO-186 [3.0, Sys V] 

MS-286 3.0T 


SCO-286 Sys V 

SCO-286 [3.0, Sys V] 

DOS* 


MS-286 Sys V 

MS-286 [3.0t, Sys V] 


SCO-386 System V 

SCO-86 Sys V 

SCO-86 [3.0, Sys V] 

SCO-286 3.0 


SCO-186 Sys V 

SCO-186 [3.0, Sys V] 

MS-286 3.0t 


SCO-286 Sys V 

SCO-286 [3.0, Sys V] 

DOS* 


SCO-386 Sys V 

SCO-386 [Sys V] 



MS-286 Sys V 

MS-286 [3.0f, Sys V] 



MS-386 Sys V 

MS-386 [Sys V] 


MS-286 3.0t 

MS-286 [3.0t, Sys V] 
SCO-286 Sys V 

SCO-286 3.0 

DOS* 

MS-286 System V 

MS-286 Sys V 

SCO-86 [3.0, Sys V] 

DOS* 


SCO-286 Sys V 

SCO-186 [3.0, Sys V] 
SCO-286 [3.0, Sys V] 


MS-386 System V 

MS-386 Sys V 

SCO-86 [3.0, Sys V] 

DOS* 


SCO-386 Sys V 

SCO-186 [3.0, Sys V] 
SCO-286 [3.0, Sys V] 
SCO-386 [Sys V] 



* MS-DOS for i8086/8088, i80186 and i80286 processors, 
t MS-286 3.0 XENIX is equivalent to Intel 286 3.0 XENIX. 
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See Also 


cc(CP), ld(CP), a.out(F) 
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mouse 

system mouse 

Description 


UNIX supports mice attached directly to controller cards on the bus 
and mice attached to standard serial ports. The command: 

mkdev mouse 

is used to configure a new mouse or to reconfigure an existing mouse. 

See Also 


Files 


/dev/mouse 
/dev/mouse/bus [0-1 ] 

/de v/mouse/vpix [0-1 ] 

/dev/mouse/microsoft_ser 

/dev/mouse/logitech_ser 

/dev/mouse/mousesys_ser 

/dev/mouse/ttyp[0-7] 

/etc/default/usemouse 

/usr/lib/event/devices 

/usr/lib/event/ttys 

/usr/lib/mouse/* 


Directory for mouse-related special device files. 
Bus mouse device files, 
vpix-mouse device files. 

Microsoft serial mouse device files. 

Logitech serial mouse device files. 

Mousesys serial mouse device files. 

Special pseudo-tty files for mouse input. 

Default map file for mouse-generated characters 
File containing device information for mice. 

File listing ttys eligible to use mice. 

Alternate map files for mice. 


mkdev(ADM), usemouse(C) 


Value Added 


mouse is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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parallel _ 

parallel interface devices 

Description 

There are several parallel devices: 

/dev/lpO Main parallel adapter. 

/dev/lpl Adapter on monochrome video card. 

/dev/lp2 Alternate parallel adapter (on appropriate machines). 

It is not possible to have all three parallel devices on one system. 
Some AT computers allow the use of two parallel devices, /dev/lp2, 
and either /dev/lpO or /dev/lpl. However, available devices vary from 
machine to machine, and may instead allow either /dev/lpO, or and 
either /dev/lpl, and /dev/lp2. 

If a parallel device fails to interrupt properly, the parallel driver enters 
“poll mode.” Once interrupts are received from the device, the driver 
returns to its original mode. 

The parallel driver delays a certain amount of time when a parallel de¬ 
vice is closed. The amount of delay can affect printer performance, 
but is necessary to compensate for different sizes of printer buffers and 
printer speeds. For example, this command sets the delay on close to 
1 second, specified in lOths of a second: 

stty time 10< /dev/lpO 

When given from a prompt, this command will only work if the port is 
open. It is recommended that a variation of this command be placed 
in the interface script used with the parallel device to achieve the 
same results: 

stty time 10 0< &1 

Notes _: 


Parallel adapters on add-on cards will function, but switches must be 
set correctly. Some compatible computers have ports lpO and lpl 
reversed. 

The stty{C ) command for output processing is supported on a parallel 
device, stty options that have no effect on a parallel device are 
ignored and no error messages are displayed. 
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Usually invoked by lp( C), but can be written to directly. 

Files 


/dev/lpO 

/dev/lpl 

/dev/lp2 

See Also 


lp(C), lp(HW), lpadmin(ADM), lpsched(ADM), serial(HW) 
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prf _ 

operating system profiler 

Description 


The special file /dev/prf provides access to activity information in the 
operating system. Writing the file loads the measurement facility with 
text addresses to be monitored. Reading the file returns these 
addresses and a set of counters indicative of activity between adjacent 
text addresses. 

The recording mechanism is driven by the system clock and samples 
the program counter at line frequency. Samples that catch the operat¬ 
ing system are matched against the stored text addresses and incre¬ 
ment corresponding counters for later processing. 

The file /dev/prf is a pseudo-device with no associated hardware. 

Files 


/dev/prf 

See Also 


profiler/ADM) 
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ramdisk 

memory block device 

Description 


The ramdisk device driver provides a block interface to memory. A 
ramdisk can be used like any other block device, including making it 
into a file systems using m^(ADM). There are eight ramdisks avail¬ 
able. 

The characteristics of a ramdisk file are determined by its minor de¬ 
vice number. The bits in the minor device number encode its size, 
longevity, and which of the eight possible ramdisks it is. 

The three low-order bits of the minor device number determine which 
of the eight ramdisks is being accessed. 

The next four bits of the minor device number determine the size of 
the ramdisk . The size of a ramdisk must be a power of 2, and must be 
at least 16K. Since 4 bits are available, there are 16 possible sizes, 
starting at 16K and doubling every time the size indicator is incre¬ 
mented, to produce possible sizes of 16K, 32K, 64K, and up. 

The high-order bit is a longevity indicator. If set, memory is per¬ 
manently allocated to that ramdisk , and can be deallocated only by 
rebooting the system. Permanent ramdisks can only be allocated by 
the superuser. However, once a permanent ramdisk is allocated (by 
opening it), it can be read and written by anyone having the appropri¬ 
ate permissions on the ramdisk inode. 

If clear, the ramdisk is deallocated when no processes have it open. 
To create an easily removable, but semi-permanent ramdisk , use a 
separate process to keep the device open for as long as necessary. 

Since a complete set of ramdisks (8) would consume 256 inodes, only 
one example 16K ramdisk (/dev/ramOO) is created when the system is 
installed. The system administrator can check this existing file to 
determine the major device number for any other required ramdisks. 
All ramdisks will use the same major device number. 

The following table shows how the minor device number is con¬ 
structed: 
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Example Minor Device N umber Construction _ 

Description Longe- Size (see Ram Minor 

vity next table) Disk No. Device 

Number 


16K (#1) 

(Temporary) 

0 

0 

0 

0 

0 

0 

0 

1 

1 

16K (#1) 

(Permanent) 

1 

0 

0 

0 

0 

0 

0 

1 

129 

64K (#0) 

(Temporary) 

0 

0 

0 

1 

0 

0 

0 

0 

16 

512K (#7) 
(Permanent) 

1 

0 

1 

0 

1 

1 

1 

1 

175 


The contents of the size field and the corresponding ramdisk size 
is shown in the next table. 



To create a ramdisk, follow these steps: 

1. Create the device node. 

You must first create the device that the ramdisk will reside on. It has 
the form: 


mknod devicejiame b_or_c major devicejiumber minor_device_number 

where b_or_c “b” or “c”. °b” is for blocked devices and is the one 
you will - use. The major number will always be 31. The minor num¬ 
ber is derived from the table above. The minor number is the sum of 
the three attribute columns. 
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Longevity: 

pennanent = 128 non-permanent = 0 
Size: 

16K = 0 128K = 24 1 Meg = 48 8 Meg = 72 

32K = 8 256K = 32 2 Meg = 56 16 Meg = 80 

64K =16 512K = 40 4 Meg = 64 32 Meg = 88 

Ram Disk number: 0 through 7 Note: There are only 8 devices avail¬ 
able. Two different size devices may not share the same number. 

For example, to create a 64K permanent ramdisk, the minor number 
could vary from 144 to 151. If the disk number was 1 the mknod com¬ 
mand would be: 

mknod /dev/ram64 b 31 145 

2. Make a file system. 

This creates a file system on the the ramdisk. In this example mkfs 
has the form: 

mkfs device name size_ofJileJn_Bsize blocks 
In this example, the command to create a 64K file system would be: 
mkfs /dev/ram64 64 

3. Mount the filesystem. 

This mounts the selected device on the specified mount point. It has 
the form: 


mount device_name mount_point 

In order to mount the example 64K ramdisk on /mnt the command 
would be: 


mount /dev/ram64 /mnt 

To make a file system on a non-permanent ramdisk , the device file 
must be held open between the mkfs and the mount (ADM) operations. 
Otherwise, the ramdisk is allocated at the start of the mkfs command, 
and deallocated at its end. Once the ramdisk is mounted, it is open 
until it is unmounted. 
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The following shell fragment shows one way to use mkfs on a non- 
permanent 512K ramdisk, then mount it: 


( /etc/mkfs /dev/ram40 512 

/etc/mount /dev/ram40 /mnt 
) < /dev/ram40 


Notes 


ramdisks must occupy contiguous memory. If free memory is frag¬ 
mented, opening a ramdisk may fail even though there is enough total 
memory available. Ideally, all ramdisks should be allocated at system 
startup. This helps prevent the ramdisks themselves from fragmenting 
memory. 

ramdisks are geared towards use in specialized applications. In many 
cases, you will notice a decrease in system performance when ram¬ 
disks are used, because UNIX can generally put the memory to better 
use elsewhere. 

Files 


/dev/ramOO 

See Also 


mkfs(ADM), mount(ADM), mknod(C) 

Value Added 


ramdisk is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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rtc_ 

real time clock interface 

Description 


The rtc driver supports the real time clock chip, allowing it to be set 
with the correct local time and allowing the time to be read from the 
chip. 


Ioctl Calls 

RTCRTIME 

This call is used to read the local time from the real time clock 
chip. The argument to the ioctl is the address of a buffer of 
RTCNREG unsigned characters (RTCNREG is defined as 
<sys/rtc.h>). The ioctl will fill in the buffer with the contents of 
the chip registers. Currently, RTCNREG is 14, and the meanings 
of the byte registers are as follows: 


Register 

Contents 

0 

Seconds 

1 

Second alarm 

2 

Minutes 

3 

Minute alarm 

4 

Hours 

5 

Hour alarm 

6 

Day of week 

7 

Date of month 

8 

Month 

9 

Year 

A 

Status register A 

B 

Status register B 

C 

Status register C 

D 

Status register D 


For further information on the functions of these registers, see your 
hardware technical reference manual. 

RTCSTIME 

This call is used to set the time into the real time clock chip. The 
argument to the ioctl is the address of a buffer of RTCNREGP 
unsigned characters (RTCNREGP as defined in <sys/rtc.h>). 
These bytes should be the desired chip register contents. 
Currently, RTCNREGP is 10, representing registers 0-9 as shown 
above. Note that only the super-user may open the real time clock 
device for writing and that the RTCSTIME ioctl will fail for any 
other than the super-user. 
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Files 

/dev/rtc 
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screen 

tty[01 -n], color, monochrome, ega, vga display adapter 
and video monitor 

Description 


The tty[01-«] device files provide character I/O between the system 
and the video display monitor and keyboard. Each file corresponds to 
a separate teletype device. Although there is a maximum of 12 
screens, the exact number available ( n ) depends upon the amount of 
memory in the computer. The screens are modeled after a 25 line, 80 
column ASCII terminal, unless specified otherwise. 

System error messages from the kernel are written to /dev/console, 
which is normally the current multiscreen. If the /dev/console is the 
default output device for system error messages, and the display being 
used is switched to graphics mode, console messages are not dis¬ 
played. When the video device returns to text mode, a notice message 
is displayed and the text of the kernel error can be recovered from 
usr/adm/messages. 

Although all ttyfOl-w] devices may be open concurrently, only one of 
the corresponding devices can be active at any given time. The active 
device displays its own screen and takes sole possession of the key¬ 
board. It is an error to attempt to access the color, monochrome, or 
ega file when no corresponding adapter exists or no multiscreens are 
associated with it. 

To get to the next consecutive screen, enter Ctrl-PrtSc using the Ctrl 
key, and the PrtSc key. Any active screen may be selected by enter¬ 
ing alt-Fn, where Fn is one of the function keys. For example, FI 
refers to the ttyOl device. 

Control Modes 


Multiscreens can be reassigned to different adapters (in multi-adapter 
systems) with these ioctl s : 


SWAPMONO Selects the monochrome display as the output 

device for the multiscreen. 

SWAPCGA Selects the regular color display as the output 

device for the multiscreen. 
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SWAPEGA Selects the enhanced color display as the out¬ 

put device for the multiscreen. 

SWAPVGA Selects the video graphics array color display 

as the output device for the multiscreen. 


To find out which display adapter type is currently attached to the 
multiscreen, you can use ioctl( S) with the following request: 


CONS_CURRENT Returns the display adapter type currently asso¬ 
ciated with the multiscreen. The return value 
can be one of: MONO, CGA, EGA, or VGA. 


Display Modes 


The following ioctls can be used to change the video display mode: 

SW B80x25 Selects 80x25 black and white text display 

mode. (MONO, CGA, EGA, VGA) 

SW C80x25 Selects 80x25 color text display mode. (CGA, 

EGA, VGA) 


SW B40x25 Selects 40x25 black and white text display 

mode. (MONO, CGA, EGA, VGA) 

SW_C40x25 Selects 40x25 color text display mode. (CGA, 

EGA, VGA) 


SW BG320 Selects 320x200 black and white graphics 

display mode. (CGA, EGA, VGA) 

SW CG320 Selects 320x200 color graphics display mode. 

(CGA, EGA, VGA) 

SW BG640 Selects 640x200 black and white graphics 

display mode. (CGA, EGA, VGA) 

SW_EGAMONO80x25 Selects EGA (Enhanced Graphics Adapter) 
mode 7 - emulates support provided by the 
monochrome display. (EGA, VGA) 
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SW_EGAMONOAPA 

Selects EGA support for 640x350 graphics 
display mode (EGA mode F). (EGA with mono 
monitor) 

SW_ENHMONOAPA2 

Selects EGA mode F*. (EGA with mono moni¬ 
tor) 

SW_ENHB40x25 

Selects enhanced EGA support for 40x25 black 
and white text display mode. (EGA, VGA) 

SW_ENHC40x25 

Selects enhanced EGA support for the 40x25 
color text display mode. (EGA, VGA) 

SW_ENHB80x25 

Selects enhanced EGA support for 80x25 black 
and white text display mode. (EGA, VGA) 

SW_ENHC80x25 

Selects enhanced EGA support for 80x25 color 
text display mode. (EGA, VGA) 

SW_ENHB80x43 

Selects enhanced EGA support for 80x43 black 
and white text display mode. (EGA, VGA) 

SW_ENHC80x43 

Selects enhanced EGA support for 80x43 color 
text display mode. (EGA, VGA) 

SW_CG320_D 

Selects EGA support for 320x200 graphics 
display mode. (EGA mode D.) (EGA, VGA) 

SW_CG640_E 

Selects EGA support for 640x200 graphics 
display mode (EGA mode E). (EGA, VGA) 

SW_CG640x350 

Selects EGA support for 640x350 graphics 
display mode (EGA mode 10). (EGA, VGA) 

SW_ENH_CG640 

Selects EGA mode 10*. (EGA, VGA) 

SW_MCAMODE 

Reinitializes the monochrome adapter. 

(MONO) 

SW_VGA40x25 

Selects VGA support for the 40x25 color text 
display mode (VGA mode 1+). (VGA) 

SW_VGA80x25 

Selects VGA support for the 80x25 black and 
white text display mode (VGA mode 2+). 
(VGA) 
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SW_VGAM80x25 


SW_VGA11 

SW_VGA12 

SW_VGA13 


Selects VGA mode 7+ - emulates support pro¬ 
vided by the monochrome display. (VGA with 
mono monitor) 

Selects VGA support for the 640x480 graphics 
display mode (VGA mode 11). (VGA) 

Selects VGA support for the 640x480 graphics 
display mode (VGA mode 12). (VGA) 

Selects VGA support for the 320x200 graphics 
display mode (VGA mode 13). (VGA) 


Switching to an invalid display mode for a display device will result 
in an error. 

Getting Display Modes 


The following ioctl() requests are provided to obtain information 
about the current display modes: 


CONS_GET 

CGA.GET 

EGA_GET 

MCA.GET 

VGA.GET 


CONS_GETINFO 

struct vid_info 
{ 


Returns the current display mode setting for 
current display adapter. (All) 

Returns the current display mode setting of the 
color graphics adapter. (CGA only) 

Returns the current display mode setting of the 
enhanced graphics adapter. (EGA only) 

Returns the current display mode setting of the 
monochrome adapter. (MONO only) 

Returns the current display mode of the video 
graphics adapters. (VGA only) 

Returns structure vidjnfo (below). Size of 
structure (first field) must be filled in by user. 


short 

size; 

/* must be first field 

*/ 

short 

m num; 

/* multiscreen number, 0 based 

*/ 

ushort 

mv row, mv_col; 

/* cursor position 

*/ 

ushort 

mv rsz, mv_csz; 

/* text screen size 

*/ 

struct 

colors mv_norm. 

/* normal attributes 

*/ 


mv_rev. 

/* reverse video attributes 

V 


mv_grfc; 

/* graphic character attributes 

*/ 

uchar t 

mv ovscan; 

/* border color 

*/ 

uchar_t mk_keylock; 

/* caps/num/scroll lock 

*/ 


}; 
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CONS_6845INFO 

Returns structure m6845_info (below). Size of 
structure (first field) must be filled in by user. 

struct m6845 info 
{ 

short size; 

/* must be first field */ 


ushort screen_top; /* offset of screen in video */ 
ushort cursor_type; /* cursor shape */ 

}; 


CONSADP 

Returns number of multiscreen displayed on 
adaptor associated with that multiscreen. 

GIO_ATTR 

Return value of ioctl is 6845-style attribute 
byte in effect. 

GIO.COLOR 

Return value of ioctl is zero or one depending 
on whether the device supports color. 

GIO.SCRNMAP 

Gets the 256-byte screen map table, which is 
the mapping of ASCII values (0-256) onto the 
PC video ROM font characters (0-256). Note 
that control characters (ASCII values less than 
hex 20) have control functions and do not 
display ROM characters (example: *J is new- 
line). 

This is often used to map the low font values 
that normally correspond to ASCII control 
values to higher ASCII values, thus displaying 
the desired ROM characters. 

PIOJSCRNMAP 

Puts the 256-byte screen map table (see 
GIO.SCRNMAP). 

PIO_KEYMAP 

See keyboard( HW) 

PIOJCEYMAP 

See keyboard^ HW) 

GIO_FONT8X« 

Gets font, where n is 8, 14, and 16. Argument 
is a pointer to a font table. Size of 8X8 font 
table is 8X256 bytes, 8X14 is 14X256 bytes, 
etc. 

PIO_FONT8Xn 

Puts font, where n is 8,14, and 16. Argument is 
a pointer to a font table. Size of 8X8 font table 
is 8X256 bytes, 8X14 is 14X256 bytes, etc. 
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Memory Mapping Modes 


The ioctl ( S) routine is used to map the display memory of the various 
devices into the user’s data space. 

Note that the MAP* ioctls map the memory associated with the 
current mode. You must put the adapter into the desired mode before 
performing mapping, or the pointers returned will not be appropriate. 
Refer to your hardware manual for details on various displays, 
adapters, and controllers. 

These ioctl () requests can be used to map the display memory: 

MAPCONS Maps the display memory of the adaptor 

currently being used into the user’s data space. 
(All) 

MAPMONO Maps the monochrome adapter’s display 

memory into the user’s data space. (MONO 
only) 


MAPCGA Maps the color adapter’s display memory into 

the user’s data space. (CGA only) 


MAPEGA 


Maps the enhanced graphics adapter’s display 
memory into the user’s data space. (EGA only) 


MAPVGA Maps the video graphics adapter’s display 

memory into the user’s data space. (VGA only) 


For example, the following code can be used to acquire a pointer to 
the start of the user data space associated with the color graphics 
adapter display memory: 

char *dp; 
int retval; 


/* fd is a file descriptor for a 
multiscreen device */ 
retval = ioctl (fd, MAPCONS,OL); 
dp = (char *) retval; 
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Note that when the display memory is mapped into the user space, the 
adapter’s m6845 start address registers are not set. The start address 
can be reset in two ways, so that the start address of the display mem¬ 
ory corresponds to the upper left hand comer of the screen: 

1. Switch modes with an ioctlQ (the “switch” can be to the 
present mode). See the “Display Modes” section of this manu¬ 
al page. 

2. Change the start address high and low address with the 
in-on-portlout-on-port ioctlQ. 

The in-on-portl out-on-port ioctl()’s can also be used to determine the 
current value in the start address register, and then set up a pointer to 
point to the offset in the mapped-in data space. 

MAP.CLASS 

Package ioctl that gives I/O privileges to an arbitrary list of ports 
and maps an arbitrary frame buffer into user’s address space 
identified by a string found in the struct vidclass vidclasslist[] 
located in /etc/conf/pack.o/class.h. 

KDDISPTYPE 

This call returns display information to the user. The argument 
expected is the buffer address of a structure of type kdjiisparam 
into which display information is returned to the user. The 
kdjiisparam structure is defined as follows: 

struct kd_disparam { 

long type; /^display type*/ 

char *addr; /*display memory address*/ 

ushort ioaddr[MKDIOADDR]; /*valid I/O addresses*/ 


Possible values for the type field include: 

KD_MONO (0x01), for the IBM monochrome display adapter. 

KD_HERCULES (0x02), for the Hercules monochrome graphics 
adapter. 

KD_CGA (0x03), for the IBM color graphics adapter. 

KD_EGA (0x04), for the IBM enhanced graphics adapter. 
KD_VGA (0x05), for the IBM video graphics adapter. 
KDDISPINFO 

Returns struct kdjiisparam , which contains adaptor type and phy¬ 
sical address of frame buffer. 
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KIOCSOUND 

Start sound generation. T\im on sound. The arg is the frequency 
desired. A frequency of 0 turns off the sound. This is useful for 
generating tones while in graphics mode. 

KDGETLED 

Get keyboard LED status. The argument is a pointer to a charac¬ 
ter. The character will be filled with a boolean combination of the 
following values: 

1 scroll lock 

2 num lock 
4 caps lock 

KDSETLED 

Set keyboard LED status. The argument is a character whose 
value is the boolean combination of the values listed under 
“KDGETLED”. 

KDMKTONE 

Not supported. (See KIOCSOUND.) 

KDADDIO 

Not supported. (See MAP_CLASS.) 

KDDELIO 

Not supported. (See MAP_CLASS.) 

KIOCDOSMODE 
Not supported. 

KIOCNONDOSMODE 
Not supported. 

KDSETMODE 

(VP/DC only.) Set console in text or graphics mode. The argument 
is of type integer, which should contain one of the following 
values: 

KD_TEXT 0x00 (sets console to text mode) 

KD_GRAPHICS 0x01 ( sets console in graphics mode) 

Note, the user is responsible for programming the color/graphics 
adaptor registers for the appropriate graphical state. 

KDGETMODE 

(VP/DC only.) Get current mode of console. Returns integer argu¬ 
ment containing either KD_TEXT or KD_GRAPHICS as defined 
in the KDSETMODE ioctl description. 

KDENABIO 

Enable in’s and out’s to video adaptor ports. No argument. 
KDDISABIO 

Disable in’s and out’s to video adaptor ports. No argument. 
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KDGKBTYPE 
Always returns 0. 

KDGKBMODE 

Get keyboard translation mode, also known as scan code mode. 
Mode is returned where arg points. 

KDSKBMODE 

Set keyboard translation mode, also known as scan code mode. 
KDGKBSTATE 

Returns the state of the shifted, alt-, or control- state of the key¬ 
board. Returns a bollean combination of: 

1 shifted 

2 control- 
4 alt- 

KIOCINFO 

Always returns 0x6664. 

KDMAPDISP 

(VP/ix only) Maps display memory into user process address 
space. Argument is a pointer to structure type kdjnemloc. This 
ioctl requires that a virtual 8086 subtask be attached to the current 
process. KDMAPDISP should not be used by ordinary users to 
map the console display; use MAPCONS. 

KDUNMAPDISP 

(VP/ix only) Unmap display memory from user process address 
space. No argument required. 

VT.SETMODE 

Set the virtual terminal mode. The argument is a pointer to a 
vt_mode structure, as defined below. 

VT_GETMODE 

Determine what mode the active virtual terminal is currently in, 
either VT_AUTO or VT_PROCESS. The argument to the ioctl is 
the address of the following type of structure: 

struct vt_mode { 

char mode; /* VT mode */ 

char waitv; /* not implemented */ 

short relsig; /* signal to use for release request */ 
short acqsig; /* signal to use for display acquired */ 
short frsig; /* not implemented */ 

} 

fdefine VT_AUTO 0x00 /* automatic VT switching */ 

#define VT_PROCESS 0x01 /* process controls switching */ 

The vt_mode structure will be filled in with the current value for each 
field. 
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VT.RELDISP 

Used to tell the virtual terminal manager that the display has or has 
not been released by the process. 

0 == release refused 

1 == release acknowledged 

2 == acquire acknowledged 

VT_ACTIVATE 

Makes the multiscreen number specified in the argument the active 
multiscreen. The video driver will cause a switch to occur in the 
same manner as if a hotkey sequence had been typed at the key¬ 
board. If the specified multiscreen is not open or does not exist, 
the call will fail and ermo will be set to ENXIO. 

Graphics Adapter Port I/O __ 

You can use ioctl (S) to read or write a byte from or to the graphics 
adapter port. The arg parameter of the ioctl call uses the ioarg data 
structure: 

struct port_io_arg { 

struct port_io_struct args[4]; 

}; 

As shown above, the io_arg structure points to an array of four port_io 
data structures. The port jo structure has the following format: 

struct port_io_struct { 

char dir; /* direction flag (in vs. out) */ 
unsigned short port; /* port address */ 
char data; /* byte of data */ 

}; 


You may specify one, two, three, or four of the port jo struct struc¬ 
tures in the array for one ioctl call. The value of dir can be either 
IN_ON_PORT to specify a byte being input to the graphics adapter 
port or OUT_ONJPORT to specify a byte being output to the graphics 
adapter port. Port is an integer specifying the port address of the 
desired graphics adapter port. Data is the byte of data being input or 
output as specified by the call. 

If you are not using any of the port jo structures, load the port with 0, 
and leave the unused structures at the end of the array. Refer to the 
hardware manuals for port addresses and functions for the various 
adapters. 

You can use the following ioctl(S) commands to input or output a byte 
on the graphics adapter port: 
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CONSIO 

Inputs or outputs a byte on the current graphics 
adapter port as specified. (All) 

MGAIO 

Inputs or outputs a byte on the monochrome 
adapter port as specified. (MONO only) 

CGAIO 

Inputs or outputs a byte on the color graphics 
adapter port as specified. (CGA only) 

EGAIO 

Inputs or outputs a byte on the enhanced graph¬ 
ics adapter port as specified. (EGA only) 

VGAIO 

Inputs or outputs a byte on the video graphics 
array adapter port as specified. (VGA only) 


To input a byte on any of the graphics adapter ports, load dir with 
IN_ON_PORT and load port with the port address of the graphics 
adapter. The byte input from the graphics adapter port will be returned 
in data. 

To output a byte, load dir with OUT_ON_PORT, load port with the 
port address of the graphics adapter, and load data with the byte you 
want output to the graphics adapter port. 

Function Keys 


ioctl(S) can be used to define or obtain the current definition of a func¬ 
tion key. The arg parameter of the ioctl call uses the fkeyarg data 
structure: 

struct fkeyarg { 

unassigned int keynum; 
char keydef [MAXFK]; 

/* Comes from 

char flen; ioctl.h via comcrt.h */ 

} 

You can use the following ioctl(S) requests to obtain or assign func¬ 
tion key definitions: 

GETFKEY Obtains the current definition of a function key. 

The function key number must be passed in 
keynum. The string currently assigned to the 
key will be returned in keydef and the length of 
the string will be returned in flen when the ioctl 
is performed. 
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Assigns a given string to a function key. The 
function key number must be passed in keydef 
and the length of the string (number of charac¬ 
ters) must be passed in flen. 

Toggles the <Caps Lock> and <Num Lock> 
keys to be either global to all the multiscreens, 
or local to each individual multiscreen. To 
make the <Caps Lock> global (its default), set 
the arg parameter to 1. To make the 
<Caps Lock> local to each screen, set the arg 
parameter to 0. 

ANSI Screen Attribute Sequences 


The following character sequences are defined by ANSI X3.64-1979 
and may be used to control and modify the screen display. Each n is 
replaced by the appropriate ASCII number (decimal) to produce the 
desired effect. The last column is for termcap (M) codes, where “n/a” 
means not applicable. 

The use of 7 or 8 bit characters in the escape sequence is a valid invo¬ 
cation for each action defined. For example the ANSI ED command 
can be invoked via the “ESC [ n J” (0xlb-0x5b-/i-0x4a, 7 bit chars) 
sequence or the “CSI n J” (0x9b-n-0x4n, 8 bit chars) sequence. 


SETFKEY 

SETLOCKLOCK 


ISO 

Sequence 

Action 

Termcap 

Code 

ED 

(Erase in 
Display) 

CSI/I J 

Erases all or part of a 
display. n=0: erases from 
active position to end of 
display, n—1 : erases from 
the beginning of display to 
active position. n—2 : 
erases entire display. 

cd 

EL 

(Erase in 
Line) 

CSI/t K 

Erases all or part of a line. 
n=0: erases from active 
position to end of line. 
n-1 : erases from begin¬ 
ning of line to active posi¬ 
tion. n—2 : erases entire 
line. 

ce 

ECH 

(Erase 

Character) 

CSIn X 

Erases n characters 

n/a 
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CBT 

(Cursor 

Backward 

Tabulation) 

CSIn Z 

Moves active position 
back n tab stops. 

bt 

SU 

(Scroll 

Up) 

CSIn S 

Scroll screen up n lines, 
introducing new blank 
lines at bottom. 

sf 

SD 

(Scroll 

Down) 

CSIn T 

Scrolls screen down n 
lines, introducing new 
blank lines at top. 

sr 

CUP 

(Cursor 

Position) 

CSIm;n H 

Moves active position to 
location m (vertical) and n 
(horizontal). 

cm 

HVP 

(Horizontal 
& Vertical 
Position) 

CSIm;« f 

Moves active position to 
location m (vertical) and n 
(horizontal). 

n/a 

CUU 

(Cursor Up) 

CSIn A 

Moves active position up n 
number of lines. 

up (ku) 

CUD 

(Cursor 

Down) 

CSIn B 

Moves active position 
down n number of lines. 

do (kd) 

CUF 

(Cursor 

Forward) 

CSIn C 

Moves active position n 
spaces to the right. 

nd (kr) 

CUB 

(Cursor 

Backward) 

CSIn D 

Moves active position n 
spaces backward. 

bs (kl) 

HPA 

(Horizontal 

Position 

Absolute) 

CSIn ‘ 

Moves active position to 
column given by n. 

n/a 

HPR 

(Horizontal 

Position 

Relative) 

CSIn a 

Moves active position n 
characters to the right. 

n/a 
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VPA 

(Vertical 

Position 

Absolute) 

CSIn d 

Moves active position to 
line given by n. 

n/a 

VPR 

(Vertical 

Position 

Relative) 

CSIn e 

Moves active position 
down n number of lines. 

n/a 

IL 

(Insert 

Line) 

CSIn L 

Inserts n new, blank lines. 

al 

ICH 

(Insert 

Character) 

CSIn @ 

Inserts n blank places for n 
characters. 

ic 

DL 

(Delete 

Line) 

CSIn M 

Deletes n lines. 

dl 

DCH 

(Delete 

Character) 

CSIn P 

Deletes n number of char¬ 
acters. 

dc 

CPL 

(Cursor to 

Previous 

Line) 

CSIn F 

Moves active position to 
beginning of line, n lines 
up. 

n/a 

CNL 

(Cursor 

Next 

Line) 

CSIn E 

Moves active position to 
beginning of line, n lines 
down. 

n/a 
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SGR CSI/z m Character attributes, as n/a 

(Select summarized in the chart 

Graphic below. Multiple attributes 

Rendition) can be specified in the 

form: CSI nl\ n2 ; n3 m 


Select Graphic Rendition (SGR) Chart 

n 


Meaning 

0 

all attributes off (normal display) 

1 

bold intensity (or light color) 

4 

underscore on (if hardware supports it) 

5 

blink on (if hardware supports it) 

7 

reverse video 


8 

sets blank (non-display) 

10 

selects the primary font 

11 

selects the first alternate font: lets ASCII 


characters less 
ROM characters 

than 32 be displayed as 

12 

selects a second alternate font; toggles high 
bit of extended ASCII code before display¬ 
ing as ROM characters 

30 

black 

foreground 

31 

red 

foreground 

32 

green 

foreground 

33 

brown 

foreground 

34 

blue 

foreground 

35 

magenta 

foreground 

36 

cyan 

foreground 

37 

white 

foreground 

38 

enables underline option; white foreground 
with white underscore 

39 

disables underline option 

40 

black 

background 

41 

red 

background 

42 

green 

background 

43 

brown 

background 

44 

blue 

background 

45 

magenta 

background 

46 

cyan 

background 

47 

white 

background 


ISO Sequence Action Termcap 

Code 


SM CSI[2h Lock keyboard. Ignores n/a 

(Set Mode) keyboard input until 

unlocked. Characters are 
not saved. 
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MC CSI[2i Send screen to host. 

(Media Current screen contents are 

Copy) sent to the application. 

RM CSI[21 Unlock keyboard. Re- 

(Reset enable keyboard input. 

Mode) 

Additional Screen Attribute Sequences 

n/a 

n/a 

Name 

Sequence 

Action 

Termcap 

Code 

n/a 

CSl=p;dB 

Set the bell parameter to the 
decimal values of p and d. p is 
the period of the bell tone in units 
of 840.3 nanoseconds, and d is the 
duration of the tone in units of 
100 milliseconds. 

n/a 

n/a 

CSl=s;eC 

Set the cursor to start on scanline 
s and end on scanline e. 

n/a 

n/a 

CSl=xD 

T\im on or off (jc= 1 or 0) the 
intensity of the background color. 

n/a 

n/a 

CSI=xE 

Set or clear (jc= 1 or 0) the Blink 
vs. Bold background bit in the 
6845 crt controller. 

n/a 

n/a 

CSI=cA 

Set overscan color to color c. c is 
a decimal value taken from Color 
Table above. (This sequence may 
not be supported on all hardware.) 

n/a 

n/a 

CSI = cF 

Set normal foreground color to c. 
(c is a decimal parameter taken 
from Color Table.) 

n/a 

n/a 

CSI =cOG 

Set normal background. (See 
Color Table.) 

n/a 

n/a 

CSI = c H 

Set reverse foreground. (See 
Color Table.) 

n/a 


September 24,1990 SCREEN-16 






SCREEN(HW) SCREEN(HW) 


n/a 

CSI = c I 

Set reverse 
Color Table.) 

background. 

(See 

n/a 

n/a 

CSI=c J 

Set graphic 
Color Table.) 

foreground. 

(See 

n/a 

n/a 

CSI=c K 

Set graphic 
Color Table.) 

background. 

(See 

n/a 


Color Table 

Cn 

Color 

Cn 

Color 

0 

Black 

8 

Grey 

1 

Blue 

9 

Lt. Blue 

2 

Green 

10 

Lt. Green 

3 

Cyan 

11 

Lt. Cyan 

4 

Red 

12 

Lt. Red 

5 

Magenta 

13 

Lt. Magenta 

6 

Brown 

14 

Yellow 

7 

White 

15 

Lt. White 


Name Sequence Action Termcap 


n/a CSI [ n g Accesses alternate graphics set. n/a 

Not the same as 
“graphics mode.” Refer to your 
owner’s manual for 

decimal/character codes (Pn) and 
possible output characters. 


n/a ESCQFn "string" Define function key Fit with n/a 

string. String delimiters 
and ’ may be any character not 
in string . Fn is defined as the key 
number starting at zero plus the 
ASCD value of zero. For exam¬ 
ple, FI = 0... F16 = ?, and so on. 

In this escape sequence, the * 
character will cause the next 
character to have 32 subtracted 
from its ASCII value. Thus *! 
results in a soh ("A) character. 

n/a CSInz n should be equal to the number n/a 

of the screen to switch to. If 
screen does not exist, no action 
will take place. 
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/dev/console 

/dev/tty [02 -n] 

/dev/color 

/dev/monochrome 

/dev/ega 

/dev/vga 

See Also 


console(M), ioctl(S), keyboard (HW), keymap(M), 
mapchan(M), multiscreen (M), setcolor(C), stty(C), 
vidi(C), termcap(M), tty(M) 


mapkey(M), 

systty(M), 
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scsi _ 

small computer systems interface 

Description 


SCSI provides a standard interface for peripherals such as hard disks, 
printers, tape drives and others. SCSI is run via a host adapter card 
that can support up to 8 controllers, each supporting up to 8 devices. 
Note that only 4 hard disks can be attached to a controller. 

The minor device numbering scheme for SCSI disk devices is the 
same as the standard minor device number scheme for non-SCSI disk 
devices. The minor device numbering scheme for SCSI tape devices 
is as follows: 


SCSI Tape Minor Devices 


Bits 

7 6 5 4 3 2 1 0 

x x - " " - ’ r 

- - x. 

- - - X - - - - 

- - - X - - - 

-----XXX 


Description 
Unit (LUN) 

No unload on close 
High density (6250 BPI) 
No rewind on close 
Unused(reserved) 


Each SCSI controller has its own major device number. 


See Also 


hd(HW), tape(HW) 

Value Added 


scsi is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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serial: ttyl[a-h], tty 1 [A-H], tty2[a-h], 
tty2[A-H]_ 

interface to serial ports 

Description 

The ttyl[a-h], ttyl[A-H], tty2[a-h] and tty2[A-H] files provide 
access to the standard and optional serial ports of the computer. Each 
file corresponds to one of the serial ports (with or without modem con¬ 
trol). Files are named according to the following conventions: 

- The first number in the file name corresponds to the COM expan¬ 
sion slot. 

Lower case letters indicate no modem control. 

- Upper case letters indicate the line has modem control. 

tty la and ttyl A both refer to COM 1, whereas tty 2a and tty2A both 
refer to COM 2. 

For example, with a four port expansion board installed at COM 1 and 
a single port board installed at COM 2, you can access: 


tty la 

ttyl A 

ttylb 

tty IB 

ttylc 

ttylC 

tty Id 

tty ID 

tty2a 

tty2A 


Each serial port has modem and non-modem invocations. The device 
names in the following table refer to the serial ports, with and without 
modem control. The first section of the table describes boards at COM 
1 and the second section describes boards installed at COM 2. 
“Minor” is the minor device number for the port (see mknodiC)). 
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Serial Lines 

Board 

Non-Modem 



Type 

Control 

Modem Control 



Minor 

Name 

Minor 

Name 



1 Port 

0 

ttyla 

128 

ttylA 




1 

ttylb 

129 

tty IB 


4 Port 

2 

ttylc 

130 

ttylC 




3 

ttyld 

131 

ttylD 



4 

ttyle 

132 

ttylE 

8 Port 

5 

ttylf 

133 

tty IF 



6 

ttylg 

134 

ttylG 



7 

ttylh 

135 

ttylH 



1 Port 

8 

tty2a 

136 

tty2A 




9 

tty2b 

137 

tty2B 


4 Port 

10 

tty2c 

138 

tty2C 




11 

tty2d 

139 

tty2D 



12 

tty2e 

140 

tty2E 

8 Port 

13 

tty2f 

141 

tty2F 



14 

tty2g 

142 

tty2G 



15 

tty2h 

143 

tty2H 


Interrupt Vectors: 

All board(s) installed at COM 1-4 
All board(s) installed at COM 2-3 

For a list of I/O addresses, see the Release Notes furnished with your 
distribution. 

Access 


The files may only be accessed if the corresponding serial interface 
card is installed and its jumper I/O address correctly set. Also, for 
multi-port expansion cards, you must use the mkdev( ADM) program to 
create more than the default number of files. Unless other COM slots 
are specifically referred to in your hardware documentation, only 
COM 1 and COM 2 may be used. 

The serial ports must also be defined in the system configuration. 
Check your hardware manual to determine how your system is config¬ 
ured, via a CMOS database or by switch settings on the main system 
board. If your system is configured using a CMOS database, the ports 
are defined in the database (see c/was (HW)). Otherwise, define the 
ports by setting the proper switches on the main system board. Refer 
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to your computer hardware manual for switch settings. 

It is an error to attempt to access a serial port that has not been 
installed and defined. 

The serial ports can be used for a variety of serial communication pur¬ 
poses such as connecting login terminals to the computer, attaching 
printers, or forming a serial network with other computers. Note that a 
serial port may operate at most of the standard baud rates, and that the 
ports (on most computers) have a DTE (Data Terminal Equipment) 
configuration. The following table defines how each pin is used for 
25-pin and 9-pin connections: 


25-Pin 

9-Pin 

Description 

2 

2 

Transmit Data 

3 

3 

Receive Data 

4 

7 

Request to Send 

5 

8 

Clear to Send 

7 

5 

Signal Ground 

8 

1 

Carrier Detect (Data Set Ready) 

20 

4 

Data Terminal Ready 


Only pins 2, 3, and 7 (2,3 and 5 for 9-pin) are necessary for a terminal 
(or direct) connection. 


A modem control device (port) uses pins 2, 3, and 7 in the same way 
as a non-modem control device: send on pin 2 and receive on pin 3. 
Pin 7 is data ground. On a non-modem control device, pins 4 and 20 
(RTS and DTR) are asserted, but pin 8 is not. On a modem control de¬ 
vice, pins 4 and 20 (RTS & DTR) are asserted and the port will not 
open until pin 8 (CXD) is asserted. That is, no signal travels from pin 
2 until pin 8 is asserted from another source. The modem control de¬ 
vice monitors the the status of pin 8. 


See tty(M) and termio (M) for the details of serial line operation on 
UNIX systems. 


Files 


/dev/tty l[a-h] 
/dev/tty 1[A-H] 
/dev/tty2[a-h] 
/dev/tty2[A-H] 


See Also 


cmos(HW), csh(C), cu(C), getty(ADM), mkdev(ADM), mknod(C) 
nohup(C), open(S), termio(M), tty(M), uucp(C) 
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If you login via a modem control serial line, hanging up logs that line 
out and kills your background processes. See no hup (C) and csh(C)). 

You cannot use the same serial port with both modem and non-modem 
control at the same time. For example, you cannot use tty la and ttyl A 
simultaneously. 

Use a modem cable to connect your modem to a computer. 
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tape 

magnetic tape device 

Description 


The tape device implements the UNIX interface with a tape drive. 
QIC-02 cartridge tape drives are supported by the ct device driver, 
QIC-40 and QIC-80 tape drives connected to the floppy disk controller 
are supported with the ft device driver, and Irwin tape drives con¬ 
nected to the floppy disk controller are supported with the me device 
driver. Typically, the tar(C), cpio(C), dd(C), backup (ADM), 
xbackup (ADM), xrestore (ADM), or restore (ADM) commands are 
used to access a tape drive. 

A single tape drive with a raw (character, non-blocking) interface is 
supported, except for the SCSI tape driver which supports up to four 
devices. There are four standard tape device types. Devices beginning 
with the “r” prefix, (for “raw device”), should be used for most nor¬ 
mal tape work, while devices with the “n” prefix, (“for no rewind on 
hold”), should be used for storing and restoring multiple files. De¬ 
vices beginning with the “x” prefix are control devices, which are 
used for sending ioctl (S) commands to the tape subsystem. 

Devices beginning with the “e” prefix (for ECC device) support a 
2/64 error recovery scheme. Thus two 512-byte blocks out of every 64 
blocks can be bad and the driver will correct the errors. This software 
ECC support provides a high degree of error recovery. 

Theft and me floppy tape drivers do not support the “n” or “e” device 
types. ECC encoding and decoding is automatically used with the 
standard “r” device. On the QIC-40, QIC-80 and Irwin 80MB drives, 
for every 29K written to the tape, 3K of ECC data is written with it to 
provide error recovery. On the Irwin 10, 20, 40 and 60MB drives, for 
every 16K written to the tape, 2K of ECC data is written. 

QIC-40 and QIC-80 tapes must be formatted with the tape (C) com¬ 
mand before use, unless you use pre-formatted tapes. Similarly, Irwin 
tapes must be first servo-written and then formatted with tape(C) 
before use, unless you use pre-formatted tapes. The me driver can 
read tapes formatted and written under XENIX but cannot write to 
them. 

The following table summarizes the base naming conventions for the 
tape drives supported: 

ct0,l QIC24 unit 0,1 

ct2,3 QIC11 unit 0,1 

Stpfl, 1,2,3 SCSI tape unit 0,1,2,3 
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ftO 


QIC-40 or QIC-80 floppy tape unit 
Irwin floppy tape unit 


mcO 

ctmini 

mtO,l 

mt2,3 

mt4,5 


default mini-cartridge device 
reel to reel unit 0,1 1600 bpi 
reel to reel unit 0,1 800 bpi 
reel to reel unit 0,1 6250 bpi 


The default tape device is stored in the file /etc/default/tape, which is 
also used by tape(C). /etc/default/tape should always contain the “x” 
(control) device name of the default device, and is normally updated 
by m^v(ADM) tape. If the default device is a QIC-40, QIC-80 or 
Irwin tape drive, the appropriate device from the table above will be 
linked to the ctmini device node. QIC-02 tape drives will always be 
accessed by the ctO,l device nodes as shown in the table. If a SCSI 
tape drive is installed as the default device and there is no QIC-02 
drive installed, it will be linked to the ctO device node. If both SCSI 
and QIC-02 drives are installed, the SCSI device node cannot be 
linked to the ctO device node. 

tape(C) describes the commands used to access tape drives. 

Definition of ioctl commands 


The following ioctl commands can be used with the various tape de¬ 
vice drivers supported under UNIX. The letters following each 
description indicate which drivers support each ioctl command: 

A All drivers 

C QIC-02 cartridge tape driver 

S SCSI tape driver 

F QIC-40 and QIC-80 mini-cartridge tape drivers 

I Irwin mini-cartridge tape driver 


MTSTATUS 

Returns a device-independent structure holding the status of the 
drive. The tape info structure is defined in 
/usr/mclude/sys7tape.h. (C,S,F) 

MTDSTATUS 

Returns a device-dependent structure holding status information of 
the drive. (C,S,F) 

MTRESET 

Resets the driver software and the tape drive. Interrupts tape com¬ 
mands in progress. (C,S JF) 

MTREPORT 

Returns an integer code which determines the type of device which 
the driver controls. The type numbers are defined in 
/usr/include/sys/tape.h. (C,S,F) 
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MTRETEN 

Winds the tape forward to EOT and then backward to BOT. 
(C,S,F) 

MTREWIND 

Rewinds the tape to BOT. (C,S,F) 

MTERASE 

Erases the data on the tape and retensions the cartridge. (C,S,F) 
MTAMOUNT 

Returns an integer count of the amount of the last data transfer. 
(C,S,F) 

MTFORMAT 

Formats the tape. Expects as an argument the number of tracks to 
format, which must be an even number. If no argument is pro¬ 
vided, the default is 20 tracks for QIC-40 drives, and 28 tracks for 
QIC-80 drives. (F) 

MTGETHDR 

Expects as an argument a pointer to a struct ftjieader or struct 
ir header and copies the header of the current tape into it. (F) 

MTPUTHDR 

Takes a pointer to a struct ftjieader or struct irjieader and writes 
it onto the tape. This command should be used with caution. (F) 

MTGETNEWBB 

Takes a pointer to a struct ftjiewbbt or struct irjiewbbt and copies 
in a list of bad blocks detected on the last write operation. (F) 

MT PUTNEWBB 

Takes a pointer to a struct ftnewbbt or struct irjiewbbt, reads in 
the header from the tape, then writes a new bad block onto the tape 
with the new bad blocks from the provided bad block table. (F) 

MTGETVTBL 

Takes a pointer to a struct ft_ytbl and copies in the volume table 
from the tape. (F) 

MT PUTVTBL 

Takes a pointer to a struct ft_vtbl and writes the volume table onto 
the tape. This command should be used with caution. (F) 

MTJRFM 

Winds the tape forward to the next file mark. (C,S) 

MTWFM 

Writes a file mark at the current location on the tape. (C,S) 
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MTLOAD 

On devices which are capable of doing so, loads the tape into the 
drive. (S) 

MTUNLOAD 

On devices which are capable of doing so, unloads the tape from 
the drive. (S) 

Irwin-specific ioctl Interface 


Device specific functions of the Irwin tape drive are accessed via spe¬ 
cial commands passed to the Irwin driver using the ioctl() interface. 
An Irwin driver interface library is available. This library provides a 
system independent interface to ioctl() via the entry point mcioctlf): 

#include "mc.h" 

int mcioctl (fh, and, arg) 

int fh; /* File handle from open() */ 

int and; /* MCCTL_* command code */ 

void *arg; /* Additional argument pointer */ 


mcioctl (fh, MCCTLJSTOP, NULL) 

mcioctl (fh, MCCTL_VERSION, verbuf) 

mcioctl (fh, MCCTL_CAPAC ITY, capp) 

mcioctl (fh, MCCTL_LSEEK, lskbuf); 

mcioctl (fh, ^CTL_REWIND) 

mcioctl (fh, MCCTL_RETEN) 

mcioctl (fh, MCCTL_REWIND_NW) 

mcioctl (fh, MCCTL_RETEN_NW) 

mcioctl (fh, MCCTL_GETDRVCFG, cfgbuf) 

mcioctl (fh, MCCTLjGETCFG, cfgbuf) 

mcioctl (fh, MCCTL_SETCFG, cfgbuf) 

mcioctl (fh, MCCTL_GETTHDR, hdrbuf) 

mcioctl (fh, MCCTL_PUTTHDR, hdrbuf) 

mcioctl(fh, MCCTL_GETDLISTS, listbuf) 

mcioctl (fh, MCCTL_FLUSH) 

mcioctl (fh, MCCTL_FORMAT, fmtbuf) 

mcioctl (fh, MCCTL_FMTSTAT, fmtbuf) 

mcioctl(fh, MCCTL_ABORT) 

mcioctl (fh, MCCTL_DEVSTAT, dstatp) 

mcioctl (fh, MCCTL_GETERCTL, erctlp) 

mcioctl (fh, MCCTL_SETERCTL, erctlp) 

mcioctl (fh, MCCTL_GETER, ierrp) 

struct mcver *verbuf; /* version buffer */ 

long *capp; /* capacity in bytes */ 

struct mclseek *lskbuf; /* tape logical position descriptor */ 

struct mccfg *cfgbuf; /* configuration buffer */ 

char *hdrbuf; /* 1024 byte header buffer */ 

unsigned short * listbuf; /* 2048 byte defect list buffer */ 

struct rncfrnt * fmtbuf; /* format control/status buffer */ 

unsigned short * dstatp; /* device status word */ 

unsigned short *erctlp; /* error control word */ 

unsigned short *ierrp; /* device specific error */ 
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mcioctl() provides system independent ioctl interface to the Irwin 
driver. This subroutine is essentially a pass-through. That is, argu 
ments are passed through to ioctl(). If a device specific error occurs 
(i.e., a non-system error) at completion of the system ioctl() and the 
command is other than MCCTL.NOP or MCCTLVERSION, 
mcioctl() executes ioctl(MCCTL_GETER) to retrieve the device spe¬ 
cific error. 

The following ioctl commands are available for the Irwin driver: 
MCCTL_NOP 

No operation. The argument is ignored. A success status is 
returned. This command may be used as an aid in determining if a 
special file refers to the MC driver. 

MCCTL_VERSION 

Gets driver version information. The argument is the address of 
version information buffer (see struct mover in 
/usr/include/sys/mc.h) to which the driver writes. 

MCCTL_CAPACITY 

Gets a tape’s capacity in bytes. The argument is the address of a 
long integer. 

MCCTLREWIND 

MCCTL_RETEN 

MCCTLREWINDNW 

MCCTLRETENNW 

These four commands physically position the tape at high speed. 
MCCTLRETEN and MCCTL_RETEN_NW run the tape to the 
early warning hole first. All four commands return the tape 
to the load-point hole. MCCTL_REWIND_NW and 
MCCTL_RETEN_NW start a request but don’t wait for comple¬ 
tion. 

MCCTLGETDRVCFG 

MCCTLGETCFG 

MCCTLJSETCFG 

These three commands provide access to configuration parameters 
for a particular mini cartridge tape unit. The structure of these 
parameters is struct mccfg (defined in /usr/include/sys/mc.h) This 
structure has driver, tape drive, and cartridge related fields. Both 
MCCTL_GETDRVCFG and MCCTL_GETCFG copies the 
driver’s the MCCFG structure to the caller’s buffer. When 
MCCTL_GETDRVCFG is used, struct mccfg members with driver 
and tape drive related fields are returned. No error is given when a 
cartridge is absent. When MCCTL_GETCFG is used successfully, 
all fields are returned with valid data. An error is returned if no 
cartridge is present. MCCTL_SETCFG allows the caller to adjust 
certain fields in the driver’s configuration. 
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MCCTLGETTHDR 

MCCTLPUTTHDR 

MCCTL.GETTHDR and MCCTL_PUTTHDR read and write the 
1024 byte tape header in block 0. MCCTL_PUTTHDR assumes an 
Irwin style header. The the following procedure is used to write 
the header: 

Tape block 0 is read to a buffer. The caller’s 1024 byte 
header buffer is copied to the first, fifth, and when space 
permits, the ninth and thirteenth 1024-byte sectors in the 
buffer. When the cartridge format uses ECC (i.e., other 
than 110 cartridge format), the header’s ECC in use field is 
set. When the cartridge format uses ECC, ECC is encoded. 
A check sum is calculated for the buffer. The buffer is writ¬ 
ten back to block 0. Block 0 is reread and the cartridge 
state is redetermined. A new checksum is calculated and 
compared against the original. 

MCCTLGETDLISTS 

Returns lists used by the driver’s flaw management. The caller 
gives the address of a buffer which is at least 2 KB in length. Four 
lists are copied to the buffer. Each list is comprised of physical 
tape block numbers stored as unsigned short integers and ter¬ 
minated with the value Oxflff. The lists are contiguous and given in 
the following order: 

Primary Defect List (PDL) 

Working Defect List (WDL) 

Grown Defect List (GDL) 

Relocation List (RL) 

MCCTLFLUSH 

Flushes dirty buffers to tape. MCCTL_FLUSH forces dirty buffers 
in the Irwin driver’s cache to be written to tape. The pointer argu¬ 
ment is ignored. Control returns when data is written. Buffers are 
automatically flushed upon a close() or when the device is idle for 
a certain period (see mc_autoflush in struct mccfg in 
/usr/include/sys/mc.h). 

MCCTLFORMAT 

MCCTLFMTSTAT 

MCCTL_FORMAT starts a erase, servo-format-certify-initialize 
header or re-certify operations. The argument is the address of 
struct mcfmt (see /usr/include/sys/mc.h). Formatting operations 
performed depend upon the values in the structure’s fmcmd and 
fm option fields, and struct mccfg mc_cartstate field. When an 
MCCTLJFORMAT command completes successfully, 
MCCTL_FMTSTAT is used to determine the progress (when a no¬ 
wait flag is set) or results of formatting. Like MCCTLJFORMAT, 
MCCTLJFMTSTAT also uses the struct mcfmt structure (typically 
the same one passed to MCCTLJFORMAT). 
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MCCTLABORT 

Used to interrupt and terminate operations started by 
MCCTL_FORMAT. The pointer argument is ignored. Control 
returns after formatting has terminated. 

MCCTL_DEVSTAT 

Returns a 16-bit device status word to an unsigned short integer 
who’s address is passed in the third argument of ioctl(). This field 
is intended for use by applications which use the tape drive 
interactively. The status bits are defined in struct mclseek in 
/usr/include/ sys/mc.h. 

MCCTLGETERCTL 

MCCTLSETERCTL 

MCCTL_GETERCTL and MCCTLJSETERCTL give application 
access to the state of and control over certain error mechanisms. 
The argument is the address of a 16-bit error control variable 
which the Irwin driver writes with current values for 
MCCTL_GETERCTL and reads for MCCTLJSETERCTL. Cer¬ 
tain flags may or may not have an effect depending on the imple¬ 
mentation. Bit values for the error control variable are defined in 
/usi7include/sys/mc.h. 

MCCTLGETER 

Gets device specific error: IE_*. In general the value 0 is returned 
to indicate success or -1 to indicate an error. When mcioctl() 
returns the value -1, an error has occurred. The error condition 
may have been detected in the operating system or in the driver. In 
order to discriminate the origin the global jncerrno should be 
examined first (before ermo). When non-zero, the error was 
returned by the driver. Values for jncerrno are defined in 
/usr/include/ierrno.h with an IE_ prefix. 
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This section is concerned with Irwin tape drives and cartridges sup¬ 
ported. 

Drive Models 

Many Irwin mini cartridge drives have a three digit model number. 
Each digit has a meaning. The high order digit encodes the form fac¬ 
tor and cabinetry: 

lxx 5-1/4 inch drive (mounted in system cabinet). 

2xx 3-1/2 inch drive (mounted in system cabinet). 

3xx 5-1/4 inch drive in a metal cabinet w/ power supply. 

4xx 3-1/2 inch drive in a plastic cabinet (no supply). 

7xx 3-1/2 inch drive in a metal cabinet w/ power supply. 

The middle digit gives the approximate capacity, in 10 Megabyte 
units for a standard capacity (not extra long) tape: 

xlx 10 Megabytes 
x2x 20 
x4x 40 
x6x 60 
x8x 80 

The low digit encodes the drive’s normal data transfer rate (i.e., the 
floppy controller data clock rate). 

xxO 250 Kilobits/Second 
xx5 500 Kilobits/Second 
xx7 1 Megabit/Second 

In addition, a new 4-digit model numbering system is in use. These 
model numbers are associated with drives which are adaptable to 
different system hardware environments with accessory hardware kits. 

2020 3-1/2 inch, 20 Megabyte, 250 Kilobits/Second 

2040 3-1/2 inch, 40 Megabyte, 500 Kilobits/Second 

2080 3-1/2 inch, 80/120 Megabyte, 500 Kilobits/Second 

2120 3-1/2 inch, 80/120 Megabyte, 1 Megabit/Second 

Mini Cartridges 

There are three primary physical mini cartridges types: 

DC1000 185 feet of 0.150 inch wide tape (same as TC-200) 
DC2000 205 feet of 0.250 inch wide tape (same as TC-400) 
DC2120 307.5 feet of 0.250 inch wide tape 
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The DC1000 cartridge is physically thinner than DC2000 and DC2120 
cartridges. The DC2000 and DC2120 have the same physical form but 
the DC2120 has a longer tape. These cartridges are distinguished by 
their labels. Each physical cartridge type has at least two cartridge 
formats: 


Mini (Irwin) Cartridge Format Parameters 


Cart¬ 

ridge 

Format 

AccuTrak 

Reorder 
Number 
see note 

Cart- - 
ridge 

Total 

Tape 

Blocks 

Trks 

Blocks 

per 

Track 

Seel 

P< 

Blc 

Data 

tors 

IT 

>ck 

ECC 

Dens¬ 

ity 

(FTPI) 

110 

1000-10 

DC1000 

1264 

8 

158 

8 

0 

6400 

120 

2000-20 

DC2000 

1190 

14 

85 

16 

2 

6400 

120XL 

2000-30 

DC2120 

1792 

14 

128 

16 

2 

6400 

125 

1000-20 

DC1000 

1320 

12 

110 

16 

2 

10000 

145 

2000-40 

DC2000 

2480 

20 

124 

16 

2 

10000 

145XL 

2000-60 

DC2120 

3720 

20 

186 

16 

2 

10000 

165 

2000-64 

DC2000 

3936 

24 

164 

16 

2 

13200 

285 

2000-80 

DC2000 

2752 

32 

86 

29 

3 

11600 

285XL 

2000-120 

DC2120 

4160 

32 

130 

29 

3 

11600 


Notes: The suffix part of the AccuTrak Reorder Number is an approxi¬ 

mate cartridge capacity in Megabytes. 

All formats use 1024 byte MFM encoded sectors. 


Drive Read/Write Compatibility for Mini Cartridge Formats 


Drive Model (See Note) 



Cart¬ 

ridge 

Format 

410 

310 

110 

2020 

720 

420 

320 

220 

120 

725 

425 

325 

225 

125 

2040 

745 

445 

345 

245 

145 

765 

465 

265 

165 

2080 

785 

485 

285 

2120 

787 

487 

287 

Cart- 

ridge 

110 

rw 

rw 

r- 

r- 

r- 

r- 

r- 

DC 1000 

120 


rw 

_ 

r- 

r- 

r- 

r- 

DC2000 

120XL 

_ 

rw 

_ 

r- 

r- 

r- 

r- 

DC2120 

125 

_ 

_ 

rw 

rw 

r- 

r- 

r- 

DC 1000 

145 

__ 

_ 

_ 

rw 

r- 

r- 

r- 

DC2000 

145XL 

_ 

_ 

_ 

rw 

r- 

r- 

r- 

DC2120 

165 


__ 

_ 

_ 

rw 

r- 

r- 

DC2000 

285 



_ 

_ 

_ 

rw 

rw 

DC2000 

285XL 

_ 

_ 

— 

— 

— 

rw 

rw 

DC2120 


r Drive reads cartridge format 

w Drive writes cartridge format 

Incompatible: When a cartridge is formatted but incompatible 
for reading or writing, the driver reports that the cartridge is 
either incompatible or erased. 
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Extra Long (XL) DC2120 Cartridge Compatibility 

Extra long (i.e., DC2120) cartridges are incompatible with the follow¬ 
ing drives as the drive will not physically accommodate the cartridge: 
110,310,410,125,225,325,425, and 725 

Even though DC2120 cartridges are physically accepted in the follow¬ 
ing drives, they may not be formattable: 

120,220,320,420,720,2020,145, 245, 345,445, 745,2040 

Drives manufactured previous to about 1989 don’t recognize the 
longer tape. However, the MC driver is able to read and write prefor¬ 
mated extra long tapes in these drives, but it is unable to correctly for¬ 
mat them. Formatting will start, but terminate in error. To determine 
whether a drive supports formatting of DC2120 cartridges, use the 
mcart utility. If the command mcart drive reports a drive type with 
the suffix XL, formatting of DC2120 cartridges is supported. 

Files 


/dev/rStpO /dev/rctO 

/dev/nrStpO /dev/nrctO 

/dev/xStpO /dev/rct2 

/dev/rftO /dev/nrct2 

/dev/xftO /dev/xctO 


/dev/erctO /dev/rmcl 

/dev/xctO /dev/mcdaemon 

/dev/rctmini 

/dev/xctmini 

/dev/rmcO 


Include files: ^ * 

Aisr/include/sys/tape.h /usr/include/sys/ir.h 

Aisr/include/sys/ct.h /usr/include/sys/mc.h 

/usr/include/sys/ft.h ^sr/include/sys/mcheader.h 


Notes 


After certain tape operations are executed, the system returns a 
prompt before the tape controller has finished its operation. If the user 
enters another tape command too quickly, a “device busy” error is 
returned until the tape device is finished with its previous operation. 

Periodic tape cartridge retensioning and tape head cleaning are neces¬ 
sary for continued error-free operation of the tape subsystem. Use 
tape (C) to retension the tape. 

See Also 


backup(ADM), xbackup(ADM), cpio(C), dd(C), format(C), tape(C), 
tar(C), restore(ADM), xrestore(ADM) 
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terminal 

login terminal 

Description 


A terminal is any device used to enter and display data. It may be 
connected to the computer: 

- By a serial wire, either direct or dialup 

- As a virtual terminal, for example with emulator software 

- Through a display adapter 

A terminal has an associated device file /dev/tty*. 


Files 


/dev/tty* 

See Also 


console(M), disable(C), enable(C), mkdev(ADM), serial(HW), stty(C), 
vidi(C), termcap(M), term(F), terminals(M) 
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xt_ 

multiplexed tty driver for AT&T windowing terminals 

Description 


The xt driver provides virtual circuits multiplexed onto real 

lines. It interposes its own channel multiplexing protocol as a 
line discipline between the real device driver and the standard tty (M) 
line disciplines. 

Virtual tty (M) circuits are named by character-special files of the 
form Idevlxt? ? ? . File names end in three digits, where the first two 
represent the channel group and the last represents the virtual 
number (0-7) of the channel group. Allocation of a new channel group 
is done dynamically by attempting to open a name ending in 0 with 
the OJEXCL flag set. After a successful open, the tty(M) file onto 
which the channels are to be multiplexed should be passed to xt via 
the XTIOCLINK ioctl (S) request. Afterwards, all the channels in the 
group will behave as normal tty (M) files, with data passed in packets 
via the real f/y(M) line. 

The xt driver implements the protocol described in xtproto{ M) and in 
layers (M). Packets are formatted as described in xtproto (M), while 
the contents of packets conform to the description in layers { M). 

There are three groups of ioctl (S) requests recognized by xt. The first 
group contains all the normal tty ioctl (S) requests described in 
termio{ M), with the addition of the following: 

TIOCEXCL Set exclusive use mode; no further opens are per¬ 

mitted until the file has been closed. 

TIOCNXCL Reset exclusive use mode; further opens are once 

again permitted. 

The second group of ioctl (S) requests concerns control of the window¬ 
ing terminal, and is described in the header file <sys/jioctl.h>. The 
requests are as follows: 

JTYPE, JMPX Both return the value JMPX. These are used to 
identify a terminal device as an xt channel. 

JBOOT, JTERM Both generate an appropriate command packet to 
the windowing terminal affecting the layer asso¬ 
ciated with the file descriptor argument to 
ioctl (S). They may return the error code EIO if 
the system clist is empty. 
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JTIMO, JTIMOM 

JWINSIZE 

JZOMBOOT 


JAGENT 


The third group of 
and is described in 
lows: 

XTIOCTYPE 

XTIOCLINK 
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JTIMO specifies the timeouts in seconds, and 
JTIMOM in milliseconds. Invalid except on 
channel 0. They may return the error code EIO if 
the system clist is empty. 

Requires the address of a jwinsize structure as an 
argument. The window sizes of the layer associ- ,, 
ated with the file descriptor argument to ioctl (S) 
are copied to the structure. 


Generate a command packet to the windowing 
terminal to enter download mode on the channel 
associated with the file descriptor argument to 
ioctl ( S), like JBOOT; but when the download is 
finished, make the layer a zombie (ready for 
debugging). It may return the error code EIO if 
the system clist is empty. 


Send the supplied data as a command packet to 
invoke a windowing terminal agent routine, and 
return the terminal’s response to the calling pro¬ 
cess. Invalid except on the file descriptor for 
channel 0. See jagent( M). It may return the 
error code EIO if the system clist is empty. 


ioctl (S) requests concerns the configuration of xt, 
the header file <sys/xt.h>. The requests are as fol- 


Retums the value XTIOCTYPE. 

Requires an argument that is a structure, xtioclm , 
containing a file descriptor for the file to be mul¬ 
tiplexed and the maximum number of channels 
allowed. Invalid except on channel 0. This 
request may return one of the following errors: 

EINVAL nchans has an illegal value. 

ENOTTY fd does not describe a real tty( M) de¬ 
vice. 


ENXIO 

EBUSY 


linesw is not configured with xt. 


An XTIOCLINK request has already 
been issued for the channel group. 


ENOMEM There is no system memory available 
for allocating to the f*y(HW) struc¬ 
tures. 
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EIO The JTIMOM packet described above 

could not be delivered. 

HXTIOCLINK Like XTIOCLINK, but specifies that ENCODING 
MODE be used. 


XTIOCTRACE Requires the address of a tbuf structure as an 
argument. The structure is filled with the con¬ 
tents of the driver trace buffer. Tracing is 
enabled. This request is invalid if tracing is not 
configured. 

XTIOCNOTRACE Tracing is disabled. This request is invalid if 
tracing is not configured. 

XTIOCSTATS Requires an argument that is the address of an 
array of size S_NSTATS, of type Stats t. The 
array is filled with the contents of the driver 
statistics array. This request is invalid if statis¬ 
tics are not configured. 

XTIOCDATA Requires the address of a maximum-sized Link 
structure as an argument. The structure is filled 
with the contents of the driver Link data. This 
request is invalid if data extraction is not config¬ 
ured. 


Files 


/dev/xt/??[0-7] multiplexed special files 

/usr/include/sys/jioctl.h packet command types 

/usr/include/sys/xtproto.h channel multiplexing protocol definitions 

/usr/include/sys/xt.h driver specific definitions 

See Also 


layers(C), termio(M), tty(M), ioctl(S), open(S), libwindows(S), 
jagent(M), layers(M) 
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